AI代理编排API服务器

Paperclip的MCP服务器,用于将Paperclip的REST API暴露为MCP工具,使任何兼容MCP的AI客户端可以管理AI公司、代理、项目和任务。

  • by darljed
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 darljed/paperclip-mcp

使用说明

回形针mcp

MCP(模型上下文协议)服务器 回形针 人工智能代理编排API。

展示Paperclip的REST API作为MCP工具,以便任何兼容MCP的人工智能客户端(Claude Desktop、Cursor、Kiro等)都可以管理您的人工智能公司、代理、项目和任务。

工具

工具 说明
health_check 检查服务器运行状况
list_companies 列出所有公司
get_company 通过ID获取公司
create_company 创建新公司
list_agents 列出公司的代理人
get_agent 通过ID获取代理
list_projects 列出公司的项目
get_project 按ID获取项目
create_project 创建新项目
list_issues 列出公司的问题(可选择按项目筛选)
get_issue 按ID获取问题
create_issue 创建新问题/任务
list_goals 列出公司的目标
create_goal 创建新目标
get_costs 获取公司的成本汇总
get_activity 获取公司最近的活动
list_approvals 列出公司的待批准事项
approve 批准待批准
reject_approval 拒绝待审批
get_dashboard 获取公司的仪表板摘要

先决条件

  • Node.js>=18
  • 跑步 回形针 例子
  • A. 董事会API密钥 (回形针运行时需要 authenticated 模式)

获取Board API密钥

回形针实例正在运行 authenticated 模式需要一个Board API Key才能访问API。要获得一个:

  1. 在浏览器中打开回形针UI(例如。 http://localhost:3100)
  2. 使用您的帐户登录
  3. 使用CLI身份验证流--回形针CLI(pnpm paperclipai)可以通过质询/批准流程生成Board API密钥
  4. 或者,直接使用API:
    # Create a CLI auth challenge
    curl -X POST http://localhost:3100/api/cli-auth/challenges \
      -H 'Content-Type: application/json' \
      -d '{"command": "paperclip-mcp", "clientName": "Paperclip MCP", "requestedAccess": "board"}'
    
    这将返回一个 approvalUrl --登录时在浏览器中打开它以批准挑战。这 boardApiToken 来自响应的是您的API密钥。

设置

Kiro命令行界面

添加 ~/.kiro/settings/mcp.json:

{
  "mcpServers": {
    "paperclip": {
      "command": "node",
      "args": ["/path/to/paperclip-mcp/dist/index.js"],
      "env": {
        "PAPERCLIP_BASE_URL": "http://localhost:3100",
        "PAPERCLIP_API_KEY": "pcp_board_your-api-key-here"
      }
    }
  }
}

然后重新启动Kiro CLI以加载MCP服务器。

npx(无需安装)

PAPERCLIP_BASE_URL=http://localhost:3100 PAPERCLIP_API_KEY=pcp_board_... npx paperclip-mcp

克劳德桌面版

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "paperclip": {
      "command": "npx",
      "args": ["paperclip-mcp"],
      "env": {
        "PAPERCLIP_BASE_URL": "http://localhost:3100",
        "PAPERCLIP_API_KEY": "pcp_board_your-api-key-here"
      }
    }
  }
}

光标

添加到MCP配置(.cursor/mcp.json):

{
  "mcpServers": {
    "paperclip": {
      "command": "npx",
      "args": ["paperclip-mcp"],
      "env": {
        "PAPERCLIP_BASE_URL": "http://localhost:3100",
        "PAPERCLIP_API_KEY": "pcp_board_your-api-key-here"
      }
    }
  }
}

环境变量

变量 默认值 描述
PAPERCLIP_BASE_URL http://localhost:3100 回形针服务器URL
PAPERCLIP_API_KEY (无) 板API密钥(对于 authenticated 模式)

发展

git clone https://github.com/darljed/paperclip-mcp
cd paperclip-mcp
npm install
npm run build
PAPERCLIP_BASE_URL=http://localhost:3100 PAPERCLIP_API_KEY=pcp_board_... node dist/index.js

许可证

麻省理工学院