MCP Server Manager

MCP Server Manager

Cursor と Claude Desktop 向けの MCP（Model Control Protocol）サーバー管理ツールです。MCP サーバーを簡単に管理できるよう、コマンドライン（CLI）とグラフィカル（GUI）のインターフェースを提供します。

🔎 概要

MCP Server Manager を使うと、MCP（Model Control Protocol）サーバーの作成、設定、管理が簡単になります。 このプロジェクトは主に、Cursor と Claude Desktop でローカルの MCP サーバーを作成、テスト、使用したい開発者を対象としています。

📋 機能

• MCP サーバーの管理： MCP サーバーの起動、停止、再起動、監視
• 2 種類のインターフェース： コマンドラインインターフェースとグラフィカルインターフェース
• モダンなグラフィカルインターフェース： MCP サーバーを管理するためのビジュアルインターフェース
• リアルタイムログ： 各サーバーのログを生成されるたびに表示
• 双方向通信： サーバーにコマンドを送信し、応答を受信
• マルチサーバー： 複数のサーバーを同時に管理
• 永続性： インターフェースを閉じても、稼働中のサーバーは実行を継続
• 自動設定： Cursor と Claude Desktop との連携
• プロセス検出： 実行中のサーバーを自動識別
• 重複の確認： 起動時および5分ごとに重複プロセスを自動確認
• クイックセットアップ： 新しい環境向けのクイック設定システム
• サーバーのインポート： グラフィカルインターフェースから既存の MCP サーバーをインポート可能
• マルチプラットフォーム対応： Windows と macOS に対応
• 環境管理： Python 環境を自動設定

🖥️ 互換性

プラットフォーム	状態	備考
Windows	✅ 完全対応	Windows 10/11 でテスト済み
macOS	✅ 完全対応	macOS 12+ でテスト済み
Linux	⚠️ 部分対応	実験的なサポート

🔍 プロジェクトの範囲

現在の制限事項

重要： 現在の MCP Server Manager は、ローカルの MCP サーバーのみをサポートしています。

これが意味すること：

• ✅ ローカルサーバー： クライアント LLM と同じマシン上で動作する MCP サーバーを作成、設定、実行できます
• ✅ stdio トランスポート： 実装されているサーバーは、通信に標準入出力を使用します
• ✅ 限定的な管理： システムが管理するのは、"mcp_server" ディレクトリ内のサーバーのみです
• ❌ リモートサーバー： 現時点では、HTTP/SSE 経由のリモート MCP サーバーはサポートされていません
• ❌ OAuth 認証： リモートサーバーに必要な認証は、まだ実装されていません

技術的な詳細

この管理ツールで作成されるサーバーは、次のとおりです。

• 通信には stdio トランスポートのみを使用します
• ローカルプロセスとして実行されます
• 外部に公開される HTTP エンドポイントはありません
• ローカルでのテストや開発に適しています

今後のロードマップ

今後のバージョンでは、以下の追加を予定しています。

• HTTP/SSE 経由のリモート MCP サーバーのサポート
• 安全なアクセスのための OAuth 認証との統合
• クラウド環境でのサーバーの簡易ホスティング
• リモートサーバー管理用インターフェース
• Linux の完全サポート
• メトリクスとパフォーマンスのダッシュボード
• 高度なデバッグモード

📸 スクリーンショット

グラフィカルユーザーインターフェース（GUI）

コマンドラインインターフェース（CLI）

Cursor との統合

🎬 デモ動画

🛠️ 使用技術

• Python 3.10+
• Tkinter と ttkthemes による GUI
• Rich による色付きの書式設定済み CLI インターフェース
• TOML 設定管理
• Psutil によるプロセス検出
• UV による Python 環境管理

🚀 インストール

要件

• Python 3.10 以降
• Pip（Python パッケージマネージャー）

インストール手順

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

   git clone https://github.com/marcellobatiista/mcp-server-manager.git
   cd mcp-server-manager
   

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

   pip install -r requirements.txt
   

3. クイックセットアップを実行します。

   python quick_setup.py
   

インストールの確認

インストールが正常に完了したことを確認するには、次を実行します。

mcp

MCP Server Manager の現在のバージョンが表示されます。

🚀 はじめに

MCP Server Manager をすぐに使い始めるには、次の手順に従ってください。

1. 最初のサーバーを作成する

インストールが完了したら、最初の MCP サーバーを作成できます。

1. mcp コマンドでグラフィカルインターフェースを起動します
2. メイン画面で「新しいサーバーを追加」をクリックします
3. 利用可能なテンプレートから選択するか、既存のサーバーをインポートします
4. サーバーに名前を付けます
5. 「作成」をクリックして完了します

2. Cursor を設定する

Cursor でサーバーを使用するには、次の手順に従ってください。

1. Cursor を起動します
2. 設定（歯車アイコン）を開きます
3. 「MCP サーバー」セクションに移動します
4. MCP Server Manager で作成したサーバーがリストに表示されます
5. サーバーを選択して有効にします

3. クイックテスト

サーバーが正しく動作していることを確認するには、次の手順に従ってください。

1. MCP Server Manager で「開始」ボタンをクリックしてサーバーを起動します
2. Cursor を開き、新しいドキュメントを作成します
3. モデルセレクターで MCP サーバーを選択します
4. 簡単な質問を入力して応答をテストします

これで、カスタム MCP サーバーを使用する準備が整いました。

📚 使い方

グローバルコマンド「mcp」

quick_setup.py を正常に実行した後は、次のコマンドを使って、どこからでも MCP のグラフィカルインターフェースを起動できます。

mcp

ℹ️ 注: コマンドを使用できるようにするには、インストール後に新しいコマンドプロンプトを開く必要があります。

コマンドラインインターフェース（CLI）

CLI インターフェースを起動するには、次を実行します。

.\cli-launcher.bat

または、Python から直接実行します。

python cli/launcher.py

グラフィカルユーザーインターフェース（GUI）

グラフィカルインターフェースを起動するには、次を実行します。

.\gui-launcher.bat

または、Python から直接実行します。

python gui/app.py

サーバーのインポート

既存の MCP サーバーをインポートするには、次の手順に従ってください。

1. グラフィカルインターフェースを起動します
2. サーバー管理タブで「サーバーをインポート」ボタンをクリックします
3. インポートするサーバーの Python ファイル（.py）を選択します
4. システムがファイルを MCP サーバーディレクトリにコピーし、利用可能なサーバーのリストに追加します

📁 プロジェクト構成

プロジェクトは次のように構成されています。

主要なディレクトリ

mcp-server-manager/
│
├── mcp_server/                  # Servidores MCP implementados
│   ├── demon.py                 # Servidor demon MCP de exemplo
│   └── main.py                  # Ponto de entrada para servidores
│
├── cli/                         # Interface de linha de comando (CLI)
│   ├── launcher.py              # Aplicação principal CLI
│   ├── add_mcp.py               # Utilitário para adicionar novos servidores
│   └── config_util.py           # Utilitários de configuração
│
├── gui/                         # Interface gráfica de usuário (GUI)
│   ├── app.py                   # Aplicação principal GUI
│   ├── server_manager.py        # Gerenciamento de servidores
│   ├── config_manager.py        # Gerenciamento de configurações
│   ├── utils.py                 # Utilitários e helpers
│   └── assets/                  # Recursos gráficos
│
├── config/                      # Configurações do sistema
│   ├── servers.json             # Lista de servidores disponíveis
│   └── app_config.json          # Configurações da aplicação
│
├── tests/                       # Testes automatizados
│   └── test_mcp_server.py       # Testes para verificar a estrutura do projeto
│
├── tools/                       # Scripts e ferramentas auxiliares
│
└── logs/                        # Registros de execução

主要なファイル

• quick_setup.py - 初期設定を自動化します
• cli-launcher.bat - CLI を起動するショートカット
• gui-launcher.bat - GUI を起動するショートカット
• requirements.txt - プロジェクトの依存関係

🔧 設定

クライアント設定ファイル

システムは、次の場所にある設定ファイルと連携します。

• Cursor: %USERPROFILE%\.cursor\mcp.json
• Claude Desktop (Windows): %USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json
• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json

手動設定

クライアントを手動で設定する場合は、次の手順に従ってください。

Cursor

1. ファイル %USERPROFILE%\.cursor\mcp.json を開きます
2. localMcpServers リストにサーバーを追加します

Claude Desktop

1. お使いのシステムに適した設定ファイルを開きます
2. mcp.localServers セクションにサーバーへのパスを追加します

🧪 テスト

テストの実行

自動テストを実行するには：

python -m pytest tests/

tests/ ディレクトリには、次の項目を確認する自動テストが含まれています。

• 期待されるディレクトリ構造が存在すること
• 実装済みの MCP サーバーが存在すること
• Cursor／Claude Desktop のクライアントが正しく設定されていること

❤️ プロジェクトを応援する

このプロジェクトはオープンソースで、MITライセンスのもとで無料で公開されています。

☕ コーヒーをごちそうする

この MCP サーバーマネージャーがお役に立った場合は、プロジェクトの継続的な開発へのご支援をご検討ください。

☕ コーヒーをおごる

🌟 ご支援によるメリット

ご支援いただくことで、次のことに取り組めます。

• ✅ 新機能の開発
• ✅ グラフィカルインターフェースとユーザー体験の改善
• ✅ ドキュメントやチュートリアルの拡充
• ✅ Cursor および Claude Desktop の新しいバージョンとの互換性の維持
• ✅ 問題の解決やコミュニティのサポートに、より多くの時間を充てること

🤝 その他の貢献方法

• コード： プルリクエストを送って、プロジェクトの改善にご協力ください
• アイデア： 提案や希望する機能を issue として投稿してください
• 共有： このプロジェクトが役立ちそうな人に紹介してください
• ドキュメント： チュートリアルやドキュメントの改善にご協力ください

❓ よくある質問（FAQ）

Model Control Protocol（MCP）とは何ですか？

MCP は、Cursor や Claude Desktop などのアプリケーションが言語モデルと通信できるようにするプロトコルです。アプリケーションがこれらのモデルにリクエストを送信する方法と、応答を受け取る方法を定義します。

MCP Server Manager を使うには Python の知識が必要ですか？

必ずしも必要ではありません。既存のサーバーを使う場合は、グラフィカルインターフェース（GUI）が直感的で、プログラミングの知識は不要です。ただし、独自の MCP サーバーを開発する場合は、Python の基本的な知識が推奨されます。

MCP Server Manager は Cursor や Claude Desktop 以外のアプリケーションでも使えますか？

はい。アプリケーションが MCP プロトコルをサポートしていれば使用できます。ただし、ドキュメントとテストでは、主に Cursor および Claude Desktop との連携を対象としています。

ローカルの MCP サーバーを実行しても安全ですか？

はい。ローカルの MCP サーバーはお使いのマシン上でのみ実行され、外部に HTTP エンドポイントを公開しません。通信は stdio（標準入出力）経由で行われるため、外部に情報が公開されるリスクが抑えられます。

MCP Server Manager はシステムリソースを多く消費しますか？

いいえ。MCP Server Manager は軽量で効率的に動作するよう設計されています。リソースの消費量は、主に実行している個々の MCP サーバーによって異なります。

MCP Server Manager は本番環境で使用できますか？

現在、MCP Server Manager は開発環境およびテスト環境での使用に適しています。本番環境での使用については、リモートサーバーのサポートや追加のセキュリティ機能を備えた今後のバージョンをお待ちいただくことをおすすめします。

🔒 セキュリティ

セキュリティ対策

MCP Server Manager は、以下のセキュリティ上の考慮事項に基づいて開発されています。

• ローカルでの隔離：MCP サーバーはローカルで実行されるため、外部への露出リスクを最小限に抑えられます
• 公開エンドポイントなし：現在の実装では、公開されている HTTP エンドポイントはありません
• 入力の検証：ユーザー入力は処理前に検証されます
• プロセス管理：サーバープロセスは安全な方法で監視、管理されます

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。

---

_{❤️ を込めて Marcelo Batista が開発}