Toolbox - MCP Server Manager

Toolbox - MCP サーバー管理ツール

MCP サーバーの管理と設定ファイルの生成を行う Web アプリケーションです。

機能

• リポジトリの管理（追加、表示、削除）
• GPT を使用した README ファイルからの情報の自動抽出
• YAML および JSON 設定の生成
• React と Tailwind CSS を使用したモダンな UI
• リポジトリ管理と設定生成のためのコマンドラインツール
• リポジトリのベクトルベース検索

プロジェクト構成

プロジェクトは、次の 2 つの主要な部分で構成されています。

• バックエンド：API エンドポイント用の FastAPI サーバー
• フロントエンド：Tailwind CSS を使用した React アプリケーション

前提条件

• Python 3.8+
• Node.js 18+
• Git
• OpenAI API キー
• Qdrant ベクトルデータベース（リポジトリの保存と検索用）

はじめに

バックエンドのセットアップ

1. backend ディレクトリに移動します。

cd backend

2. 仮想環境を作成します。

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. 依存関係をインストールします。

pip install -r requirements.txt

4. FastAPI サーバーを起動します。

python run.py

API は http://localhost:8020 で利用できます。

フロントエンドのセットアップ

1. frontend ディレクトリに移動します。

cd frontend

2. 依存関係をインストールします。

npm install

3. 開発サーバーを起動します。

npm run dev

Web アプリケーションは http://localhost:5173 で利用できます。

API ドキュメント

バックエンドの起動後、次の URL から API ドキュメントにアクセスできます。

• Swagger UI：http://localhost:8020/docs
• ReDoc：http://localhost:8020/redoc

コマンドラインツール

このアプリケーションには、次の 2 つのコマンドラインツールが含まれています。

サーバー追加ツール

このツールを使用すると、Git リポジトリをデータベースに追加できます。

python backend/add_server.py https://github.com/username/repo.git

オプションの引数：

• --name：リポジトリのカスタム名
• --description：リポジトリのカスタム説明
• --command：リポジトリを実行するためのカスタムコマンド
• --args：コマンドのカスタム引数

設定ツール

このツールでは、設定を管理できます。

python backend/cli.py generate-yaml

利用可能なコマンド：

• generate-yaml：YAML 設定ファイルを生成します
  • -o, --output：出力ファイルのパスを指定します
  • -p, --print：YAML を stdout に出力します
• list：データベース内のすべてのリポジトリを一覧表示します

開発に関する注意事項

• OpenAI API キーは backend/app/services/openai_service.py にハードコードされています。本番環境では、環境変数に置き換える必要があります。
• リポジトリデータは Qdrant ベクトルデータベースに保存されます。Qdrant インスタンスが適切に設定され、定期的にバックアップされていることを確認してください。
• Qdrant の接続パラメーターは、アプリケーションの「ベクトル設定」セクションで設定できます。

ライセンス

MIT