JobNimbus MCP 服务器

此项目提供一个 模型上下文协议 (MCP) 服务器，用于通过兼容的 AI 助手（如 Cursor 和 Claude）与 JobNimbus API 进行交互。

它允许 AI 代理通过标准工具访问和操作 JobNimbus 数据（联系人、工作、任务、产品、工作流程、发票），使用您的 JobNimbus API 密钥进行安全访问。

此服务器已发布到 npm，可以轻松使用 npx 运行。

设置说明

按照以下步骤为特定的 AI 助手进行设置。

用于 Cursor Editor 的设置

1. 先决条件：

   • 安装了 Cursor Editor。
   • 安装了 Node.js 和 npm（需要 npx）。
   • 您的 JobNimbus API 密钥。

2. 配置 Cursor：

   • 在您的主目录中创建 ~/.cursor 目录（如果不存在）。

   • 在该目录中创建文件 mcp.json（如果不存在）。

   • 将以下内容添加到 mcp.json 文件中：

     {
       "jobnexus": {
         "apiEndpoint": "YOUR_JOBNEXUS_API_ENDPOINT",
         "apiKey": "YOUR_JOBNEXUS_API_KEY"
       }
     }
     

3. 启动 Cursor：

   • 在终端中运行：

     npx jobnexus
     

用于 Claude 的设置

1. 先决条件：

   • 安装了 Claude。
   • 安装了 Node.js 和 npm（需要 npx）。
   • 您的 JobNimbus API 密钥。

2. 配置 Claude：

   • 在终端中运行：

     npx jobnexus
     

工具实现

• 联系人：

  • listContacts(): 获取所有联系人。
  • getContact(id): 根据 ID 获取特定联系人。
  • createContact(contact): 创建新联系人。
  • updateContact(id, contact): 更新现有联系人。

• 工作：

  • listJobs(): 获取所有工作。
  • getJob(id): 根据 ID 获取特定工作。
  • createJob(job): 创建新工作。
  • updateJob(id, job): 更新现有工作。

• 任务：

  • listTasks(): 获取所有任务。
  • getTask(id): 根据 ID 获取特定任务。
  • createTask(task): 创建新任务。
  • updateTask(id, task): 更新现有任务。

• 产品：

  • listProducts(): 获取所有产品。
  • getProduct(id): 根据 ID 获取特定产品。
  • createProduct(product): 创建新产品。
  • updateProduct(id, product): 更新现有产品。

• 工作流程：

  • getAllWorkflows(): 获取所有工作流程及其状态。
  • createWorkflow(workflow): 创建新工作流程。
  • createWorkflowStatus(status): 创建新工作流程状态。

• 发票：

  • listInvoices(): 获取所有发票。
  • getInvoice(id): 根据 ID 获取特定发票。
  • createInvoice(invoice): 创建新发票。
  • updateInvoice(id, invoice): 更新现有发票。
  • sendInvoice(id): 通过电子邮件发送特定发票。
  • recordPayment(id, payment): 记录对特定发票的付款。

开发

如果您想贡献或修改服务器：

1. 克隆仓库：git clone <repository_url>
2. 安装依赖项：cd jobnexus-mcp-server && npm install
3. 修改 src/ 目录中的内容。
4. 构建：npm run build
5. 本地测试（需要 .env 文件或导出的 API 密钥）：
   • 直接运行：npm start
   • 带自动重载运行：npm run dev
   • 链接进行全局测试：npm link（完成记得运行 npm unlink -g jobnexus-mcp-server）

许可证

MIT