Basecamp MCP Server

🚀 Basecamp 基地营地 MCP 服务器中文文档

Basecamp 基地营地 MCP 服务器是一个支持多种功能的集成平台，能实现与 AI 工作流平台的连接、访问项目聊天记录以及对 Basecamp 项目进行管理，为用户提供了便捷高效的服务。

🚀 快速开始

先决条件

• 安装 Python 3.8 或更高版本
• 安装 pip 包管理工具
• 安装 Docker（用于可选的容器化部署）

安装步骤

1. 克隆项目仓库：

git clone https://github.com/your-repository.git
cd basecamp-mcp-server

2. 创建并激活虚拟环境（推荐）：

python -m venv env
source env/bin/activate  # 在 MacOS/Linux 下
.\env\Scripts\activate  # 在 Windows 下

3. 安装依赖项：

pip install -r requirements.txt

4. 配置环境变量，编辑 .env 文件：

BASECAMP_API_KEY=your_basecamp_api_key
COMPOSIO_API_KEY=your_composio_api_key

5. 启动服务器：

python mcp_server.py

✨ 主要特性

• MCP（模型上下文协议）集成：支持与 Composio 等 AI 工作流平台的连接。
• Campfire 聊天室整合：提供对 Basecamp 项目聊天记录的访问。
• Basecamp 项目管理功能：实现对 Basecamp 项目的增删改查操作。

📦 安装指南

环境配置

1. 确保满足先决条件，即安装 Python 3.8 及以上版本、pip 包管理工具和 Docker（可选）。
2. 按照上述安装步骤进行操作，依次完成克隆仓库、创建激活虚拟环境、安装依赖项、配置环境变量和启动服务器。

💻 使用示例

基础用法

MCP 服务端点

• 工具清单获取

GET /mcp/tools

• 工具执行接口

POST /mcp/tool

Basecamp 操作示例

• 获取项目列表：

curl http://localhost:5001/projects

高级用法

Basecamp 操作示例

• 创建新项目：

curl -X POST http://localhost:5001/projects \
     -H "Content-Type: application/json" \
     -d '{"name": "我的新项目"}'

• 获取特定项目的聊天记录：

curl http://localhost:5001/campfires/123  # 123 是项目 ID

📚 详细文档

架构概述

核心组件

1. MCP 服务器
   • 实现 MCP 协议，作为与 Composio 等平台交互的桥梁。
   • 提供标准化接口，支持工具注册和执行。
2. Basecamp 集成模块
   • 负责 Basecamp 项目数据的获取和操作。
   • 处理 Campfire 聊天记录的检索和管理。
3. Composio 支持模块
   • 实现 Composio 所需的自定义接口。
   • 提供与 Composio 平台的身份验证和通信支持。

最近功能更新

2024年3月9日 - MCP 服务器改进

• 错误处理优化：引入 mcp_response 工具函数，统一处理标准错误和成功响应。
• 修复 Campfire 聊天室问题：
  • 更新项目聊天室数据获取接口 URL 格式，从 projects/{project_id}/campfire.json 修改为 buckets/{project_id}/chats.json。
  • 新增支持获取聊天记录内容的功能。
• 增强搜索能力：纳入聊天内容检索功能。
• 统一响应格式：优化所有操作的输出格式，提升可读性。

2024年3月9日 - Composio 支持新增

• 自定义身份验证：实现与 Composio 的双向认证机制。
• 新端点开发：
  • /composio/tools：用于工具注册。
  • /composio/execute：处理任务执行请求。

🔧 技术细节

数据存储

• 使用 SQLite 或 PostgreSQL 存储项目和聊天数据，默认配置为 SQLite 文件 db.sqlite3。

安全措施

• 实施严格的认证授权机制，确保只有合法用户可以访问敏感数据。
• 所有 API 请求均需携带有效的身份验证令牌。

📄 常见问题

1. 如何获取 Basecamp 的 API Key？
   • 登录 Basecamp 账户，在开发者文档中申请 API 访问权限。
2. 遇到 403 错误怎么办？
   • 检查请求头是否包含有效的认证令牌。
   • 确认令牌的范围和有效期。

📞 联系方式

• 邮件：support@basecamp.com
• GitHub：https://github.com/your-repository