基地营-MCP服务器

Name: 基地营-MCP服务器
Author: QusaiiSaleem

作者：QusaiiSaleem3 星标更新：2025-09-30

安装使用来源：spider==github.com

项目介绍

🏕️ Basecamp MCP Server

一个专业的模型上下文协议（MCP）服务器，提供对Basecamp 4 API的完全编程访问。适用于AI代理、工作流自动化和自定义集成。

🚀 新增功能 v7.5.0：兼容Claude.ai！

最全面且最兼容的Basecamp MCP服务器！

v7.5 新增内容：

✅ 完全兼容Claude.ai - 在Claude网页界面中完美运行
✅ 最新MCP协议 - 支持2025-06-18规范
✅ 会话管理 - 对现代客户端进行适当的连接跟踪
✅ 自动发现 - MCP配置端点用于自动设置
✅ 简化认证 - 不需要KV存储，只需OAuth + 环境变量
✅ 超过55种专业工具 - 完全覆盖Basecamp API

🔥 从v6.0升级？ 查看UPGRADE-TO-V75.md迁移指南。

✅ 8个项目管理工具 - 完整的项目生命周期管理
✅ 11个待办事项管理工具 - 高级任务自动化与自动查找
✅ 6个通信工具 - 消息和讨论
✅ 6个文档及文件工具 - 内容管理和文件处理
✅ 4个团队管理工具 - 访问控制和权限
✅ 3个Campfire聊天工具 - 实时通讯
✅ 3个日程管理工具 - 日历和事件
✅ 4个卡片表工具 - Kanban工作流程
✅ 5个评论系统工具 - 全面协作
✅ 4个Webhooks工具 - 实时通知
✅ 2个搜索与分析工具 - 数据洞察
🆕 3个增强功能 - 自动查找、URL解析、OAuth流程

增强功能：

自动查找功能 - 没有404错误！自动找到资源ID
OAuth 2.0集成 - 完整的认证流程带有设置UI
多种认证方法 - 承载令牌、参数、环境变量
生产就绪部署 - 优化的Cloudflare Workers

✨ 功能

🛠️ 完整工具覆盖（59个工具）

项目管理（8个工具）：完整的CRUD操作、归档、构建
待办事项管理（11个工具）：列表、项目、分配、完成、定位
通信（6个工具）：消息、回复、讨论、归档
文档及文件（6个工具）：创建、编辑、上传、管理附件
团队管理（4个工具）：添加/移除人员、权限、访问控制
评论及协作（5个工具）：跨所有内容的通用评论系统
Campfire聊天（3个工具）：实时聊天消息和历史记录
日程管理（3个工具）：事件、里程碑、日历条目
卡片表（4个工具）：Kanban板、卡片、列、定位
Webhooks（4个工具）：实时通知和事件订阅
搜索与分析（2个工具）：内容搜索和活动跟踪

🔐 认证与安全

OAuth 2.0 完整认证流程带有设置UI
多认证支持 带有令牌优先级：
1. 参数中的access_token（最高优先级）
2. Authorization: Bearer TOKEN头部
3. 环境变量中的BASECAMP_ACCESS_TOKEN（备用）
个人用户令牌 而共享基础设施
安全令牌处理 带有适当验证
简化部署 - 不需要KV存储（v7.5+）

🚀 生产就绪

边缘部署 在Cloudflare Workers上
全球CDN 响应时间低于100毫秒
自动扩展 处理任意流量量
速率限制 符合Basecamp API限制
全面错误处理 带有意义的消息
自动查找功能 防止404错误

🚀 快速开始

1. 部署到Cloudflare Workers

# 克隆仓库
git clone https://github.com/QusaiiSaleem/basecamp-mcp-server.git
cd basecamp-mcp-server

# 安装依赖
npm install

# 配置环境
cp wrangler.toml.example wrangler.toml
# 编辑wrangler.toml以包含您的账户ID

# 部署到Cloudflare Workers
npm run deploy

2. 设置Basecamp OAuth集成

创建集成：访问Basecamp集成
配置设置：
- 应用名称："您的Basecamp MCP服务器"
- 重定向URI：https://your-worker.workers.dev/auth/callback
- 客户端类型：Web应用程序
设置环境变量：

echo "your_client_id" | wrangler secret put BASECAMP_CLIENT_ID
echo "your_client_secret" | wrangler secret put BASECAMP_CLIENT_SECRET
echo "your_account_id" | wrangler secret put BASECAMP_ACCOUNT_ID

3. 获取您的访问令牌

访问https://your-worker.workers.dev/setup并按照OAuth流程获取您的访问令牌。

🌐 Claude.ai集成

新增于v7.5：直接与Claude.ai网页界面集成！

快速设置

访问Claude.ai：前往claude.ai
打开设置：点击设置 → 连接器
添加远程MCP服务器：
- 名称：Basecamp MCP
- URL：https://your-worker.workers.dev
- 认证：Bearer YOUR_ACCESS_TOKEN
启用切换：开启连接器 ✅
验证工具：所有55个工具应在您的对话中出现

完整设置指南

对于详细的逐步说明，包括截图和故障排除，请参阅：

CLAUDE-AI-SETUP.md - 完整集成指南

测试您的连接

在Claude.ai中，尝试这些命令：

"列出我所有的Basecamp项目"
"显示我的当前待办事项分配"
"在项目X中创建新消息"

兼容性矩阵

客户端	v6.0	v7.5
Claude.ai	⚠️ 有限	✅ 完全
Claude桌面版	✅ 工作	✅ 工作
Smithery Playground	⚠️ 有限	✅ 完全
RelevanceAI	✅ 工作	✅ 工作
n8n	✅ 工作	✅ 工作
Make.com	✅ 工作	✅ 工作

🔧 使用示例

与RelevanceAI

代理设置 → MCP服务器 → 添加远程MCP工具
服务器URL：https://your-worker.workers.dev
认证：Bearer your_access_token_here

与Claude桌面版

添加到您的MCP配置（~/.claude/mcp_servers.json）：

{
  "basecamp": {
    "command": "node",
    "args": ["path/to/mcp-server"],
    "env": {
      "BASECAMP_ACCESS_TOKEN": "your_token_here",
      "BASECAMP_ACCOUNT_ID": "your_account_id"
    }
  }
}

直接API使用

// 增强自动查找 - 不再需要资源ID搜索！
{
  "tool": "get_todo_lists",
  "arguments": {
    "project_id": "123456"  // 就是这样！自动查找todoset ID
  }
}

// 创建待办事项，具有完整的分配控制
{
  "tool": "create_todo",
  "arguments": {
    "project_id": "123456",
    "todolist_id": "789012",
    "content": "完成项目设置",
    "due_on": "2024-12-31",
    "assignee_ids": [1001, 1002]
  }
}

// 全面评论系统
{
  "tool": "add_comment_to_recording",
  "arguments": {
    "project_id": "123456",
    "recording_id": "789012",  // 适用于任何内容类型
    "content": "这个项目进展很好！"
  }
}

// 智能URL解析
{
  "tool": "parse_basecamp_url",
  "arguments": {
    "url": "https://3.basecamp.com/999999/buckets/123456/todolists/789012"
  }
}

📚 完整工具参考

📋 项目管理（8个工具）

工具	描述	关键参数
`get_projects`	列出所有可访问的项目	-
`create_project`	创建新项目	`name`, `description`
`get_project`	获取项目详情	`project_id`
`update_project`	更新项目信息	`project_id`, `name`, `description`
`archive_project`	归档项目	`project_id`
`unarchive_project`	解归档项目	`project_id`
`get_project_construction`	获取项目工具/功能	`project_id`
`parse_basecamp_url`	解析任何Basecamp URL	`url`

✅ 待办事项管理（11个工具）

工具	描述	关键参数
`get_todo_lists` 🚀	获取待办事项列表（自动查找）	`project_id`
`create_todo_list` 🚀	创建待办事项列表（自动查找）	`project_id`, `name`
`get_todos`	获取列表中的待办事项	`project_id`, `todolist_id`
`get_all_project_todos` 🆕	获取项目的所有待办事项	`project_id`
`create_todo`	创建新的待办事项	`project_id`, `todolist_id`, `content`
`update_todo`	更新待办事项详情	`project_id`, `todo_id`, `content`
`complete_todo`	标记待办事项完成	`project_id`, `todo_id`
`uncomplete_todo`	标记待办事项未完成	`project_id`, `todo_id`
`get_my_assignments`	获取当前用户的分配	-
`get_user_assignments`	获取用户的分配	`user_id`
`reposition_todo`	更改待办事项位置	`project_id`, `todo_id`, `position`

💬 通信（6个工具）

工具	描述	关键参数
`get_message_board` 🚀	获取消息板（自动查找）	`project_id`
`get_messages` 🚀	获取消息（自动查找）	`project_id`
`create_message` 🚀	创建消息（自动查找）	`project_id`, `subject`, `content`
`update_message`	编辑消息	`project_id`, `message_id`, `content`
`get_message`	获取特定消息	`project_id`, `message_id`
`archive_message`	归档消息	`project_id`, `message_id`

📄 文档及文件（6个工具）

工具	描述	关键参数
`get_documents` 🚀	列出文档（自动查找）	`project_id`
`create_document` 🚀	创建文档（自动查找）	`project_id`, `title`, `content`
`update_document`	编辑文档	`project_id`, `document_id`, `content`
`get_document`	获取特定文档	`project_id`, `document_id`
`upload_attachment`	上传文件	`file_data`, `filename`, `content_type`
`get_uploads`	列出项目上传	`project_id`

👥 团队及人员（4个工具）

工具	描述	关键参数
`get_people`	获取项目团队	`project_id`
`get_all_people`	获取所有账户人员	-
`add_person_to_project`	授予项目访问权限	`project_id`, `person_ids[]`
`remove_person_from_project`	撤销项目访问权限	`project_id`, `person_ids[]`

💭 评论及协作（5个工具）

工具	描述	关键参数
`add_comment_to_recording`	通用评论工具	`project_id`, `recording_id`, `content`
`add_comment_to_todo`	在待办事项上评论	`project_id`, `todo_id`, `content`
`add_comment_to_message`	回复消息	`project_id`, `message_id`, `content`
`add_comment_to_document`	在文档上评论	`project_id`, `document_id`, `content`
`add_comment_to_card`	在卡片上评论	`project_id`, `card_id`, `content`

💬 Campfire聊天（3个工具）

工具	描述	关键参数
`get_campfire`	获取项目聊天	`project_id`
`get_campfire_lines`	获取聊天消息	`project_id`, `campfire_id`
`post_campfire_message`	发送聊天消息	`project_id`, `campfire_id`, `content`

📅 日程管理（3个工具）

工具	描述	关键参数
`get_schedule` 🚀	获取日程（自动查找）	`project_id`
`get_schedule_entries`	获取日程事件	`project_id`
`create_schedule_entry`	创建新事件	`project_id`, `summary`, `starts_at`

🎫 卡片表（4个工具）

工具	描述	关键参数
`get_card_table`	获取Kanban板	`project_id`
`get_cards`	获取表中的卡片	`project_id`, `card_table_id`
`create_card`	创建新卡片	`project_id`, `card_table_id`, `title`
`update_card`	更新现有卡片	`project_id`, `card_id`, `title`

🔗 Webhooks（4个工具）

工具	描述	关键参数
`get_webhooks`	列出所有Webhooks	-
`create_webhook`	创建Webhook	`payload_url`, `types[]`
`update_webhook`	更新Webhook	`webhook_id`, `payload_url`
`delete_webhook`	删除Webhook	`webhook_id`

🔍 搜索与分析（2个工具）

工具	描述	关键参数
`search`	搜索内容	`query`, `project_id`（可选）
`get_events`	获取活动/事件	`project_id`（可选）

🔍 智能特性

🧠 自动查找智能

服务器自动找到所需的资源ID，消除404错误：

// 之前：复杂的资源ID搜索
{
  "tool": "get_todo_lists",
  "arguments": {
    "project_id": "123456",
    "todoset_id": "789012"  // ← 手动查找困难
  }
}

// 现在：简单的自动查找
{
  "tool": "get_todo_lists", 
  "arguments": {
    "project_id": "123456"  // ← 自动查找todoset ID
  }
}

📈 URL智能

解析任何Basecamp URL以提取项目和资源信息：

// 输入：https://3.basecamp.com/999999/buckets/123456/todolists/789012
// 输出： 
{
  "account_id": "999999",
  "project_id": "123456", 
  "resource_type": "todolists",
  "resource