JobNimbus MCP服务器
该项目提供了 模型上下文协议（MCP） 用于通过Cursor和Claude等兼容人工智能助手与JobNimbus API交互的服务器。
它允许人工智能代理通过标准化工具访问和操作JobNimbus数据（联系人、作业、任务、产品、工作流、发票），使用您的JobNimbusneneneba API密钥进行安全访问。
此服务器发布在npm上，可以使用以下命令轻松运行 npx.
安装说明
按照以下针对您的特定AI助手的说明进行操作。
光标编辑器设置
- 先决条件：
- 已安装光标编辑器。 - 已安装Node.js和npm（需要 npx). - 您的JobNimbus API密钥。
- 配置光标：
- 创建目录 ~/.cursor 如果它不存在，请在您的主目录中。
- 创建一个名为的文件 mcp.json 在此目录内(~/.cursor/mcp.json).
- 将以下配置复制到 ~/.cursor/mcp.json:
{
"mcpServers": {
"jobnimbus-local-server": {
"description": "JobNimbus MCP Server (requires API key)",
"command": "npx",
"args": ["jobnimbus-mcp-server"],
"env": {
"JOBNIMBUS_API_KEY": "your_api_key_here"
}
}
}
}- 重要： 替换 "your_api_key_here" 在您的文件中 实际JobNimbus API密钥.
- 重新启动光标：
- 完全退出并重新启动光标编辑器。
- 验证：
- Cursor将使用以下命令自动运行服务器 npx 必要时。 - 你应该看看 jobnimbus-local-server 在Cursor的MCP设置中的可用工具下列出，或者在代理建议工具时列出。 - 现在，您可以要求Cursor使用JobNimbus工具执行操作（例如，“使用JobNimbus_List_contacts列出我的JobNimbus联系人”）。
Claude桌面应用程序的设置
- 先决条件：
- 已安装克劳德桌面应用程序。 - 已安装Node.js和npm（需要 npx). - 您的JobNimbus API密钥。
- 配置Claude：
- 找到Claude配置文件：
- 在Mac上： ~/Library/Application Support/Claude/claude_desktop_config.json - 在Windows上： %APPDATA%\Claude\claude_desktop_config.json
- 如果文件不存在，则创建该文件。如果存在，请仔细合并 mcpServers 部分。
- 添加以下配置：
{
"mcpServers": {
"jobnimbus-local-server": {
"description": "JobNimbus MCP Server (requires API key)",
"command": "npx",
"args": ["jobnimbus-mcp-server"],
"env": {
"JOBNIMBUS_API_KEY": "your_api_key_here"
}
}
}
}- 重要： 替换 "your_api_key_here" 在您的文件中 实际JobNimbus API密钥.
- 重新启动Claude应用程序：
- 完全退出并重新启动Claude桌面应用程序。
- 验证：
- Claude现在应该能够发现和使用服务器提供的JobNimbus工具。
它是如何工作的（对于两个助手）：
- 配置告诉助手使用
npx运行jobnimbus-mcp-server. npx如果尚未缓存，则自动从npm下载服务器包的最新版本。- 助手从
env进入服务器进程。
手动运行（高级/其他客户端）
如果您需要手动运行服务器进行调试或与支持stdio的其他潜在MCP客户端一起使用：
- 设置API密钥环境变量：
export JOBNIMBUS_API_KEY=your_actual_api_key_here- 运行服务器：
npx jobnimbus-mcp-server服务器将通过stdin/stdout监听MCP通信。
已实施的工具
此服务器实现与JobNimbus API端点对应的MCP工具：
联系人
jobnimbus_list_contacts：获取具有可选筛选功能的联系人列表jobnimbus_get_contact：通过ID获取特定联系人jobnimbus_create_contact：创建新联系人jobnimbus_update_contact：更新现有联系人
工作
jobnimbus_list_jobs：获取具有可选筛选功能的作业列表jobnimbus_get_job：通过ID获得特定工作jobnimbus_create_job：创建新作业jobnimbus_update_job：更新现有作业
任务
jobnimbus_list_tasks：获取具有可选筛选功能的任务列表jobnimbus_get_task：按ID获取特定任务jobnimbus_create_task：创建新任务jobnimbus_update_task：更新现有任务
产品
jobnimbus_list_products：获取具有可选筛选功能的产品列表jobnimbus_get_product：按ID获取特定产品jobnimbus_create_product：创建新产品jobnimbus_update_product：更新现有产品
工作流
jobnimbus_get_all_workflows：获取所有工作流及其状态jobnimbus_create_workflow：创建新工作流jobnimbus_create_workflow_status：创建新的工作流状态
发票
jobnimbus_list_invoices：获取具有可选筛选功能的发票列表jobnimbus_get_invoice：按ID获取特定发票jobnimbus_create_invoice：创建新发票jobnimbus_update_invoice：更新现有发票jobnimbus_send_invoice：通过电子邮件发送发票jobnimbus_record_invoice_payment：根据发票记录付款
发展
如果您想贡献或修改服务器：
- 克隆存储库：
git clone - 安装依赖项：
cd jobnimbus-mcp-server && npm install - 在
src/目录。 - 构建：
npm run build - 本地测试（需要
.env文件或导出的API密钥）：
- 直接运行： npm start - 使用自动重新加载运行： npm run dev - 全球测试链接： npm link （记住 npm unlink -g jobnimbus-mcp-server 完成时）
许可证
麻省理工学院