MCP Server Manager

🚀 MCP サーバーマネージャー

このアプリケーションは、Python で開発されたバックエンドアプリケーションで、Model Context Protocol (MCP) インターフェースと FastAPI ウェブインターフェースの両方を提供します。Claude デスクトップ版と連携して使用する MCP サーバーを管理および統合するために設計されています。

🚀 クイックスタート

MCP サーバーマネージャーを使用することで、以下のことが可能になります。

• MCP サーバーを中央で登録し、管理する
• Claude デスクトップ版との連携に使用する MCP サーバーを有効/無効にする
• 登録前にサーバーコマンドをテストする
• 設定変更後に Claude デスクトップ版を再起動する
• MCP を介して Claude から直接 FastAPI サーバーを起動する
• Web UI と MCP インターフェースを通じて機能にアクセスする

✨ 主な機能

• 中央での MCP サーバーの登録と管理
• Claude デスクトップ版との連携におけるサーバーの有効/無効化
• サーバーコマンドの事前テスト
• 設定変更後の Claude デスクトップ版の自動再起動
• MCP を介した FastAPI サーバーの起動
• Web UI と MCP インターフェースによる機能アクセス

📦 インストール

リポジトリのクローン（必要に応じて）

git clone https://github.com/yourusername/mcp-commander.git
cd mcp-commander/mcp_server_manager

仮想環境の作成

# venv を使用する
python -m venv .venv

# 仮想環境のアクティブ化
# Windows の場合
.venv\Scripts\activate
# macOS/Linux の場合
source .venv/bin/activate

依存関係のインストール

以下の方法のいずれかを選択してください。

# pip と requirements.txt を使用する
pip install -r requirements.txt

# または、pip と pyproject.toml を使用する（推奨）
pip install -e .

💻 使用例

基本的な使用法

Web インターフェース（推奨）

Web インターフェースは、MCP サーバーを管理するためのユーザーフレンドリーなインターフェースを提供します。

uvicorn main:app --host 127.0.0.1 --port 8000

その後、ブラウザを開き、http://127.0.0.1:8000 にアクセスします。

• --host 127.0.0.1：ローカルホストからのアクセスのみを許可します。
• --host 0.0.0.0：ネットワーク上の他のデバイスからのアクセスを許可します（必要に応じて）。
• --port 8000：アプリケーションが動作するポートです。

MCP インターフェース（オプション）

Claude デスクトップ版との直接の統合が必要な場合は、以下のコマンドを実行します。

python mcp_manager/mcp_server.py

MCP サーバーは標準入力/出力モードで動作します。つまり、標準入力から読み取り、標準出力に書き込みます。これは MCP プロトコルで期待される形式です。

高度な使用法

MCP ツールの使用

MCP サーバーマネージャーは、Model Context Protocol を介して以下のツールを提供します。

1. restart_claude_desktop - Claude デスクトップ版アプリケーションを検索、終了、再起動します。
2. set_server_enabled_status - Claude デスクトップ版との連携に使用する MCP サーバーを有効/無効にします。
3. install_mcp_server - 新しい MCP サーバー構成を登録します。
4. start_fastapi_server - FastAPI サーバーを起動し、デフォルトのウェブブラウザでインターフェースを開きます。

start_fastapi_server ツールの使用

Claude デスクトップ版から、MCP ツールを使用して Web インターフェースを直接起動することができます。

start_fastapi_server

カスタムポートを指定することもできます。

start_fastapi_server port=8080

これにより、以下のことが行われます。

1. FastAPI サーバーがバックグラウンドで起動されます。
2. デフォルトのウェブブラウザが開き、インターフェースが表示されます。

📚 ドキュメント

ファイル構造

プロジェクトのファイル構造は以下の通りです。

mcp_commander/
├── mcp_server_manager/
│   ├── __init__.py
│   ├── server.py
│   └── utils.py
└── tests/
    └── test_server.py

開発

開発環境を実行するには、以下の手順に従ってください。

1. リポジトリをクローンします。

git clone https://github.com/yourusername/mcp-commander.git
cd mcp-commander/mcp_server_manager

2. 仮想環境を作成し、依存関係をインストールします。

python -m venv .venv
source .venv/bin/activate  # Windows の場合は .venv\Scripts\activate を使用
pip install -r requirements.txt

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

uvicorn main:app --host 127.0.0.1 --port 8000

4. Web インターフェースにアクセスします。 http://127.0.0.1:8000

ログ

ログファイルは mcp_server_manager/log/ ディレクトリにあり、mcp_server.log という名前で保存されます。

# ログを表示する
tail -f mcp_server_manager/log/mcp_server.log

🔚 まとめ

MCP サーバーマネージャーをご利用いただき、ありがとうございます！何か問題や提案がある場合は、お気軽にメンテナンスチームにお問い合わせください。