Basecamp MCP Server

このプロジェクトはBasecamp 3にMCP統合を提供し、MCPプロトコルを通じてCursorとBasecampの直接的なやり取りを実現します。OAuth認証、トークン管理、MCPサーバー、Basecamp APIクライアントなどのコンポーネントを含み、Composio統合をサポートしています。

開発者ツール通信ツール #Basecamp統合 #MCPプロトコル #OAuth認証 #APIやり取り .Python

スコア : 2.5ポイント

ダウンロード数 : 16

更新時間 : 2025-04-28

Basecamp MCPサーバーとは？

Basecamp MCPサーバーは、Basecamp 3とやり取りするための強力なツールで、モデルコンテキストプロトコル（MCP）を通じてBasecampの機能に直接アクセスできます。OAuth認証、プロジェクト管理、チャットログの検索など、様々な機能をサポートしています。

Basecamp MCPサーバーの使い方は？

まず、OAuthアプリを設定してサーバーを起動する必要があります。その後、Cursorや他のMCPクライアントを使ってこのサーバーに接続し、様々なBasecamp操作を実行できます。

適用シナリオ

Basecampのタスク、プロジェクト、チャットログを自動化管理する必要がある企業や個人ユーザーに適しています。

主要機能

OAuth認証OAuthフローを通じて、安全にあなたのBasecampアカウントに接続します。

プロジェクト管理Basecamp内のプロジェクトを取得、作成、更新します。

チャットログ検索Basecamp内のチャットログを検索および取得します。

Composio統合AI駆動のワークフロープラットフォームComposioとのシームレスな協働をサポートします。

利点と制限

利点

Basecampのタスク管理プロセスを簡素化する

複数のMCPクライアントとの統合をサポートする

安定した効率的なAPIインターフェースを提供する

制限

Basecamp 3バージョンのみに対応している

ローカル開発環境でのテストが適している

使い方

依存関係をインストールする

Python 3.7以上と必要な依存パッケージがインストールされていることを確認してください。

環境変数を設定する

.envファイルにBasecampとMCP関連のパラメータを設定します。

OAuthアプリとサービスを起動する

OAuth認証とMCPリクエストを処理するための2つの独立したサービスを実行します。

使用例

すべてのプロジェクトを取得する現在のユーザーのすべてのBasecampプロジェクトをリストする方法を示します。

特定のプロジェクトのチャットログを検索する特定のプロジェクトからチャット会話を抽出する方法を示します。

よくある質問

OAuth認証が失敗した場合はどうすればいいですか？

サーバーが正常に応答しない場合はどうすればいいですか？

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

Basecamp 基地营地 MCP サーバーは、様々な機能をサポートする統合プラットフォームです。Composio などの AI ワークフロープラットフォームとの接続や、Basecamp プロジェクトの管理など、多くの便利な機能を提供します。

🚀 クイックスタート

Basecamp 基地营地 MCP サーバーを使い始めるには、まず環境を設定し、サーバーを起動する必要があります。以下の手順に従って操作してください。

✨ 主な機能

MCP（モデルコンテキストプロトコル）統合：Composio などの AI ワークフロープラットフォームとの接続をサポートします。
Campfire チャットルーム統合：Basecamp プロジェクトのチャット記録へのアクセスを提供します。
Basecamp プロジェクト管理機能：Basecamp プロジェクトの追加、削除、編集、検索操作を実現します。

📦 インストール

前提条件

Python 3.8 以上をインストールする
pip パッケージ管理ツールをインストールする
Docker（オプションのコンテナ化デプロイ用）をインストールする

インストール手順

プロジェクトリポジトリをクローンする：

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

仮想環境を作成してアクティブ化する（推奨）：

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

依存関係をインストールする：
```
pip install -r requirements.txt
```

環境変数を設定し、.env ファイルを編集する：

BASECAMP_API_KEY=your_basecamp_api_key
COMPOSIO_API_KEY=your_composio_api_key

サーバーを起動する：
```
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

📚 ドキュメント

🔧 技術詳細

データストレージ

プロジェクトとチャットデータを SQLite または PostgreSQL で保存します。デフォルト設定では SQLite ファイル db.sqlite3 を使用します。

セキュリティ対策

厳格な認証と承認メカニズムを実施し、合法的なユーザーのみが機密データにアクセスできるようにします。
すべての API リクエストには有効な認証トークンを含める必要があります。

📚 よくある質問

Basecamp の API Key をどのように取得できますか？
- Basecamp アカウントにログインし、開発者ドキュメントで API アクセス権を申請してください。
403 エラーが発生したらどうすればいいですか？
- リクエストヘッダーに有効な認証トークンが含まれているか確認してください。
- トークンの範囲と有効期限を確認してください。