项目管理系统

一个集成Basecamp 3与Claude的MCP服务器,提供AI驱动的项目管理功能。

  • by callandret
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 callandret/basecamp-mcp

使用说明

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设置

  1. 首选 Basecamp集成
  2. 点击“注册另一个应用程序”
  3. 填写您的应用程序详细信息:
    • 名字:Claude MCP集成
    • 重定向URI: http://localhost:3000/callback
  4. 保存并记录您的 客户端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

许可证

麻省理工学院

贡献

欢迎投稿!请打开问题或提交拉取请求。