Basecamp MCP Server

🚀 Basecamp MCP Server Chinese Documentation

Basecamp MCP Server is an integrated platform supporting multiple functions, which can solve the problem of connecting with various AI workflow platforms and managing Basecamp projects efficiently. It provides standardized interfaces and rich features to enhance work efficiency.

🚀 Quick Start

This section provides a brief overview of the Basecamp MCP Server and its main functions.

✨ Features

• MCP (Model Context Protocol) Integration: Supports connection with AI workflow platforms such as Composio.
• Campfire Chat Room Integration: Provides access to Basecamp project chat records.
• Basecamp Project Management: Enables create, read, update, and delete operations on Basecamp projects.

📦 Installation

Prerequisites

1. Install Python 3.8 or higher.
2. Install the pip package management tool.
3. Install Docker (for optional containerized deployment).

Installation Steps

1. Clone the project repository:

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

2. Create and activate a virtual environment (recommended):

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

3. Install dependencies:

pip install -r requirements.txt

4. Configure environment variables by editing the .env file:

BASECAMP_API_KEY=your_basecamp_api_key
COMPOSIO_API_KEY=your_composio_api_key

5. Start the server:

python mcp_server.py

💻 Usage Examples

MCP Service Endpoints

• Get Tool List

GET /mcp/tools

• Tool Execution Interface

POST /mcp/tool

Basecamp Operation Examples

1. Get the project list:

curl http://localhost:5001/projects

2. Create a new project:

curl -X POST http://localhost:5001/projects \
     -H "Content-Type: application/json" \
     -d '{"name": "My New Project"}'

3. Get the chat records of a specific project:

curl http://localhost:5001/campfires/123  # 123 is the project ID

📚 Documentation

Recent Feature Updates

March 9, 2024 - MCP Server Improvements

• Error Handling Optimization: Introduced the mcp_response utility function to handle standard errors and successful responses uniformly.
• Fixed Campfire Chat Room Issues:
  • Updated the URL format of the project chat room data acquisition interface from projects/{project_id}/campfire.json to buckets/{project_id}/chats.json.
  • Added support for retrieving chat record content.
• Enhanced Search Capability: Incorporated chat content retrieval functionality.
• Unified Response Format: Optimized the output format of all operations to improve readability.

March 9, 2024 - New Composio Support

• Custom Authentication: Implemented a two-way authentication mechanism with Composio.
• New Endpoint Development:
  • /composio/tools: Used for tool registration.
  • /composio/execute: Handles task execution requests.

🔧 Technical Details

Data Storage

• Use SQLite or PostgreSQL to store project and chat data. The default configuration is the SQLite file db.sqlite3.

Security Measures

• Implement a strict authentication and authorization mechanism to ensure that only legitimate users can access sensitive data.
• All API requests must carry a valid authentication token.

📚 Documentation

Frequently Asked Questions

1. How to obtain the Basecamp API Key?
   • Log in to your Basecamp account and apply for API access in the developer documentation.
2. What to do if you encounter a 403 error?
   • Check if the request header contains a valid authentication token.
   • Confirm the scope and validity period of the token.

📄 Contact Information

• Email: support@basecamp.com
• GitHub: https://github.com/your-repository