Basecamp MCP Server

🚀 Basecamp 基地營地 MCP 服務器中文文檔

Basecamp 基地營地 MCP 服務器是一個集成平臺，支持多種功能，能解決與 AI 工作流平臺連接、項目管理及聊天記錄訪問等問題，為用戶提供便捷高效的服務。

🚀 快速開始

Basecamp 基地營地 MCP 服務器是支持多種功能的集成平臺，若你想快速使用該平臺，可按以下步驟操作：

1. 確保滿足環境配置的先決條件，即安裝 Python 3.8 或更高版本、pip 包管理工具，以及可選的 Docker（用於容器化部署）。
2. 按照安裝步驟克隆項目倉庫、創建並激活虛擬環境、安裝依賴項、配置環境變量，最後啟動服務器。
3. 參考使用說明，通過 MCP 服務端點和 Basecamp 操作示例來使用服務器的各項功能。

✨ 主要特性

Basecamp 基地營地 MCP 服務器具備以下主要功能：

• MCP（模型上下文協議）集成：支持與 Composio 等 AI 工作流平臺的連接。
• Campfire 聊天室整合：提供對 Basecamp 項目聊天記錄的訪問。
• Basecamp 項目管理功能：實現對 Basecamp 項目的增刪改查操作。

📦 安裝指南

先決條件

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 操作示例

• 獲取項目列表：

curl http://localhost:5001/projects

• 創建新項目：

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：處理任務執行請求。

常見問題

1. 如何獲取 Basecamp 的 API Key？
   • 登錄 Basecamp 賬戶，在開發者文檔中申請 API 訪問權限。
2. 遇到 403 錯誤怎麼辦？
   • 檢查請求頭是否包含有效的認證令牌。
   • 確認令牌的範圍和有效期。

聯繫方式

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

🔧 技術細節

數據存儲

使用 SQLite 或 PostgreSQL 存儲項目和聊天數據，默認配置為 SQLite 文件 db.sqlite3。

安全措施

• 實施嚴格的認證授權機制，確保只有合法用戶可以訪問敏感數據。
• 所有 API 請求均需攜帶有效的身份驗證令牌。