Basecamp MCP Integration

基本能力

产品定位

Basecamp-MCP-Server 是一个集成工具，旨在通过 MCP 协议连接 Basecamp 3 与其他应用程序（如 Cursor 和 Composio），实现无缝的数据交互和自动化工作流。

核心功能

1. OAuth 2.0 认证：通过 Flask 应用处理 Basecamp 的 OAuth 2.0 流程。
2. 令牌管理：安全存储和自动刷新 OAuth 令牌。
3. MCP 协议支持：实现 MCP 协议，支持与 Basecamp 的直接交互。
4. Basecamp API 客户端：提供与 Basecamp API 交互的客户端库。
5. 搜索功能：支持搜索 Basecamp 资源。
6. Composio 集成：支持与 Composio 的 AI 工作流集成。

适用场景

1. 团队协作：通过 Cursor 或 Composio 与 Basecamp 交互，提升团队协作效率。
2. 自动化工作流：利用 Composio 的 AI 能力自动化 Basecamp 任务。
3. 开发测试：开发者可以通过 MCP 服务器测试 Basecamp API 的调用。

工具列表

1. OAuth App (oauth_app.py)：处理 Basecamp 的 OAuth 2.0 流程。
2. Token Storage (token_storage.py)：安全存储 OAuth 令牌。
3. MCP Server (mcp_server.py)：实现 MCP 协议，支持与 Basecamp 交互。
4. Basecamp Client (basecamp_client.py)：Basecamp API 的客户端库。
5. Basecamp OAuth (basecamp_oauth.py)：处理 Basecamp 的 OAuth 认证。
6. Search Utilities (search_utils.py)：搜索 Basecamp 资源的工具。

常见问题解答

1. 令牌问题：如果遇到认证错误，尝试通过 OAuth 应用重新登录。
2. MCP 连接问题：确保 OAuth 应用和 MCP 服务器都在运行。
3. API 错误：查看 oauth_app.log 和 mcp_server.log 获取详细错误信息。

使用教程

使用依赖

1. Python 3.7+：确保已安装 Python 3.7 或更高版本。
2. Basecamp 3 账户：需要一个 Basecamp 3 账户。
3. Basecamp OAuth 应用：在 Basecamp 集成页面 创建 OAuth 应用。

安装教程

1. 克隆仓库： bash git clone <repository-url> cd basecamp-mcp
2. 创建并激活虚拟环境： bash python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate
3. 安装依赖： bash pip install -r requirements.txt
4. 创建 .env 文件并配置环境变量： BASECAMP_CLIENT_ID=your_client_id BASECAMP_CLIENT_SECRET=your_client_secret BASECAMP_REDIRECT_URI=http://localhost:8000/auth/callback USER_AGENT="Your App Name ([email protected])" BASECAMP_ACCOUNT_ID=your_account_id FLASK_SECRET_KEY=random_secret_key MCP_API_KEY=your_api_key COMPOSIO_API_KEY=your_composio_api_key

调试方式

1. 启动 OAuth 应用： bash python oauth_app.py
2. 启动 MCP 服务器： bash python mcp_server.py
3. 测试 MCP 服务器： bash curl http://localhost:5001/composio/check_auth curl http://localhost:5001/composio/schema curl -X POST http://localhost:5001/composio/tool -H "Content-Type: application/json" -d '{"tool": "GET_PROJECTS", "params": {}}'

许可证

该项目遵循 MIT 开源许可条款。