JobNimbus MCP Server

基本能力

产品定位

JobNimbus MCP Server 是一个中间件服务，旨在为 AI 助手提供与 JobNimbus API 交互的能力，从而扩展 AI 助手的功能，使其能够直接操作 JobNimbus 平台上的数据。

核心功能

• 提供与 JobNimbus API 的交互接口
• 支持多种数据操作，包括创建、读取、更新和删除（CRUD）
• 通过标准化工具实现数据访问
• 支持多种 AI 助手（如 Cursor 和 Claude）

适用场景

• AI 助手需要访问和操作 JobNimbus 数据时
• 自动化工作流程，如自动创建任务或发票
• 数据查询和报告生成

工具列表

• Contacts: jobnimbus_list_contacts, jobnimbus_get_contact, jobnimbus_create_contact, jobnimbus_update_contact
• Jobs: jobnimbus_list_jobs, jobnimbus_get_job, jobnimbus_create_job, jobnimbus_update_job
• Tasks: jobnimbus_list_tasks, jobnimbus_get_task, jobnimbus_create_task, jobnimbus_update_task
• Products: jobnimbus_list_products, jobnimbus_get_product, jobnimbus_create_product, jobnimbus_update_product
• Workflows: jobnimbus_get_all_workflows, jobnimbus_create_workflow, jobnimbus_create_workflow_status
• Invoices: jobnimbus_list_invoices, jobnimbus_get_invoice, jobnimbus_create_invoice, jobnimbus_update_invoice, jobnimbus_send_invoice, jobnimbus_record_invoice_payment

常见问题解答

• 如何配置 API 密钥？ 在 mcp.json 或 claude_desktop_config.json 文件中替换 your_api_key_here 为实际的 JobNimbus API 密钥。
• 如何验证服务是否运行？ 重启 Cursor 或 Claude 应用后，检查工具列表中是否包含 jobnimbus-local-server。

使用教程

使用依赖

1. 安装 Node.js 和 npm（确保 npx 可用）
2. 获取 JobNimbus API 密钥

安装教程

配置 Cursor

1. 创建 ~/.cursor/mcp.json 文件
2. 添加配置并替换 API 密钥
3. 重启 Cursor

配置 Claude

1. 找到或创建 Claude 配置文件
2. 添加配置并替换 API 密钥
3. 重启 Claude

调试方式

1. 设置环境变量：export JOBNIMBUS_API_KEY=your_actual_api_key_here
2. 手动运行服务：npx jobnimbus-mcp-server
3. 检查服务是否通过 stdin/stdout 监听 MCP 通信

开发

1. 克隆仓库：git clone <repository_url>
2. 安装依赖：cd jobnimbus-mcp-server && npm install
3. 修改 src/ 目录中的代码
4. 构建：npm run build
5. 测试：npm start 或 npm run dev

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。