MCP Server Manager

MCP サーバーマネージャー

Claude Desktop と連携する MCP サーバーを管理するための、Model Context Protocol（MCP）インターフェースと FastAPI ウェブインターフェースの両方を提供するバックエンド Python アプリケーションです。

概要

MCP サーバーマネージャーでは、次のことができます。

• MCP サーバーを一元的に登録、管理する
• Claude Desktop で使用する MCP サーバーを有効化／無効化する
• 登録前にサーバーコマンドをテストする
• 設定変更後に Claude Desktop を再起動する
• MCP 経由で Claude から FastAPI サーバーを直接起動する
• ウェブ UI と MCP インターフェースの両方から機能にアクセスする

前提条件

• Python 3.13 以上
• pip（Python パッケージインストーラー）
• Claude Desktop（すべての機能を利用する場合）

インストール

リポジトリをクローンする（該当する場合）

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

仮想環境を作成する

# Using venv
python -m venv .venv

# Activate the virtual environment
# On Windows
.venv\Scripts\activate
# On macOS/Linux
source .venv/bin/activate

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

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

# Using pip with requirements.txt
pip install -r requirements.txt

# OR using pip with pyproject.toml (recommended)
pip install -e .

アプリケーションの実行

ウェブインターフェース（推奨）

ウェブインターフェースを使うと、使いやすい方法で 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 インターフェース（任意）

MCP 機能に直接アクセスする必要がある場合（たとえば、Claude Desktop との連携など）は、次のようにします。

python mcp_manager/mcp_server.py

MCP サーバーは stdio モードで実行されます。これは、標準入力から読み込み、標準出力に書き込むモードです。MCP プロトコルで想定されている形式です。

MCP ツール

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

1. restart_claude_desktop - Claude Desktop アプリケーションを検出し、終了してから再起動します
2. set_server_enabled_status - Claude Desktop で MCP サーバーを有効化または無効化します
3. install_mcp_server - 新しい MCP サーバー設定を登録します
4. start_fastapi_server - FastAPI サーバーを起動し、UI を表示するために既定のウェブブラウザーを開きます

start_fastapi_server ツールを使う

Claude Desktop では、MCP ツールを使ってウェブインターフェースを直接起動できます。

start_fastapi_server

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

start_fastapi_server port=8080

これにより、次の処理が行われます。

1. FastAPI サーバーをバックグラウンドで起動します
2. 適切な URL を開くために、既定のウェブブラウザーを起動します
3. ウェブインターフェースから MCP サーバーを管理できるようになります

Claude Desktop との連携

MCP サーバーマネージャーを Claude Desktop で使用するには、次の手順に従ってください。

1. ウェブインターフェースを使って MCP サーバーを登録します
2. Claude で使用するサーバーを有効にします
3. ウェブインターフェースから、または手動で Claude Desktop を再起動します

注：MCP 機能に直接アクセスする場合は、MCP サーバーマネージャーを認識できるように Claude Desktop を設定する必要があります。Claude Desktop の設定ファイルに次の内容を追加できます。

{
  "mcpServers": {
    "mcp-server-manager": {
      "command": "python",
      "args": ["path/to/mcp_manager/mcp_server.py"]
    }
  }
}

ファイル構成

• main.py：FastAPI ウェブアプリケーション
• mcp_manager/：コアモジュール
  • core_logic.py：共有ビジネスロジック
  • mcp_server.py：MCP サーバーの実装
• templates/：ウェブインターフェース用 HTML テンプレート
• static/：静的アセット（CSS、JS）

開発

開発時には、自動再読み込みを有効にしてサーバーを実行すると便利です。

uvicorn main:app --reload

コードの変更が検出されると、サーバーが自動的に再起動します。

ログ

MCP サーバーマネージャーのログは、次の場所に書き込まれます。

C:\Users\<username>\AppData\Local\MCPManager\MCPManager\mcp_server.log

サーバーで問題が発生した場合は、このファイルでデバッグ情報を確認してください。