Basecamp MCP Server

🚀 Basecamp 基地营地 MCP サーバー日本語ドキュメント

Basecamp 基地营地 MCP サーバーは、様々な機能をサポートする統合プラットフォームです。Composio などの AI ワークフロープラットフォームとの接続や、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 操作例

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