使用说明
Basecamp MCP服务器
一个MCP(模型上下文协议)服务器,将Basecamp 3与Claude集成在一起,实现了人工智能驱动的项目管理。
这个repo是使用Claude的100%vibe编码项目。您可以在此处了解该过程:https://www.callandret.com/vibe-coding-a-basecamp-mcp-server/
特性
- 项目:列出、查看和管理Basecamp项目
- 大惊小怪:创建、更新、完成和组织待办事项
- 待办事项:待办事项列表上的完整CRUD操作
- 待办事项列表组:使用颜色编码在待办事项列表中创建和组织部分
- 文件和保险库:创建和管理文档和文件夹
- 消息:在留言板上阅读和创建消息
- 评论:添加和查看任何可记录的评论
- 营火:发送和阅读聊天消息
- 牌桌:管理卡片、列和步骤
- 日程:查看和创建日程条目
- 人们:列出并查看团队成员
- 附件和上传:管理文件和附件
- 搜索:搜索所有Basecamp内容
先决条件
- Node.js 18+
- Basecamp 3帐户(或更高)
- Basecamp API凭据(客户端ID和客户端机密)
安装
来自npm(发布时)
npm install -g basecamp-mcp
来源
git clone https://github.com/callandret/basecamp-mcp.git
cd basecamp-mcp
npm install
npm run build
Basecamp API设置
- 首选 Basecamp集成
- 点击“注册另一个应用程序”
- 填写您的应用程序详细信息:
- 名字:Claude MCP集成
- 重定向URI:
http://localhost:3000/callback
- 保存并记录您的 客户端ID 和 客户端密钥
配置
克劳德桌面版
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):
{
"mcpServers": {
"basecamp": {
"command": "node",
"args": ["/path/to/basecamp-mcp/dist/index.js"],
"env": {
"BASECAMP_CLIENT_ID": "your_client_id",
"BASECAMP_CLIENT_SECRET": "your_client_secret",
"BASECAMP_CONTACT_EMAIL": "your_email@example.com"
}
}
}
}
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
BASECAMP_CLIENT_ID |
是 | 您的Basecamp OAuth客户端ID |
BASECAMP_CLIENT_SECRET |
是 | 您的Basecamp OAuth客户端密码 |
BASECAMP_CONTACT_EMAIL |
是 | Basecamp API用户代理的联系电子邮件 |
BASECAMP_REDIRECT_URI |
否 | OAuth回调URL(默认值: http://localhost:3000/callback) |
BASECAMP_APP_NAME |
否 | 用户代理的应用程序名称(默认值: Claude MCP) |
用法
配置后,重新启动Claude Desktop。然后,您可以要求克劳德:
- “显示我的所有Basecamp项目”
- “在Project X中创建新待办事项”
- “我这周的日程安排是什么?”
- “搜索有关预算的文档”
- “向团队发布消息”
认证
首次使用时,服务器将打开一个浏览器窗口进行Basecamp OAuth身份验证。授权后,令牌将在本地缓存以供将来使用。
可用工具
| 工具 | 说明 |
|---|---|
list_projects |
列出所有Basecamp项目 |
get_project |
获取项目详细信息 |
get_todoset |
获取项目的待办事项集 |
get_todolists |
列出待办事项列表 |
get_todos |
在列表中列出待办事项 |
create_todo |
创建新待办事项 |
complete_todo |
将待办事项标记为已完成 |
get_todolist_groups |
在待办事项列表中列出组/部分 |
create_todolist_group |
使用可选颜色创建组 |
reposition_todolist_group |
在列表中重新排序组 |
get_documents |
列出vault中的文档 |
create_document |
创建新文档 |
get_messages |
列出留言板消息 |
create_message |
发布新消息 |
get_campfire_lines |
阅读篝火聊天 |
create_campfire_line |
发送聊天消息 |
search |
搜索整个大本营 |
| ...以及35+以上 |
发展
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build
# Test with MCP Inspector
npm run inspect
许可证
麻省理工学院
贡献
欢迎投稿!请打开问题或提交拉取请求。