使用说明
回形针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。要获得一个:
- 在浏览器中打开回形针UI(例如。
http://localhost:3100) - 使用您的帐户登录
- 使用CLI身份验证流--回形针CLI(
pnpm paperclipai)可以通过质询/批准流程生成Board API密钥 - 或者,直接使用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
许可证
麻省理工学院
