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

项目简介

Basecamp 基地营地 MCP 服务器是一个支持多种功能的集成平台，包括：

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

架构概述

核心组件

1. MCP 服务器

   • 实现 MCP 协议，作为与 Composio 等平台交互的桥梁。
   • 提供标准化接口，支持工具注册和执行。

2. Basecamp 集成模块

   • 负责 Basecamp 项目数据的获取和操作。
   • 处理 Campfire 聊天记录的检索和管理。

3. Composio 支持模块

   • 实现 Composio 所需的自定义接口。
   • 提供与 Composio 平台的身份验证和通信支持。

环境配置

先决条件

1. 安装 Python 3.8 或更高版本
2. 安装 pip 包管理工具
3. 安装 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 服务端点

• 工具清单获取

  GET /mcp/tools
  

• 工具执行接口

  POST /mcp/tool
  

Basecamp 操作示例

1. 获取项目列表：

   curl http://localhost:5001/projects
   

2. 创建新项目：

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

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

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

最近功能更新

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