MCP Server Manager

MCP SSE Launcher

MCP サーバーを管理する Python ベースのシステムです。Supergateway で stdio ベースのサーバーを自動的にラップし、SSE エンドポイントとして公開します。また、テスト用のウェブベースのインスペクターも提供します。

主な機能

• 自動更新 - MCP サーバーを常に最新の状態に自動更新します
• バックグラウンド監視 - クラッシュしたサーバーを自動的に再起動します
• ウェブインスペクター - ブラウザーから MCP サーバーをデバッグ、テストできます
• SSE 変換 - stdio サーバーをラップして HTTP/SSE でアクセスできるようにします
• AI アシスタントとの連携 - Cursor、Claude Desktop などで動作します

クイックスタート

# 1. Install dependencies
pip install -r requirements.txt

# 2. Set up environment (copy .env.example to .env and add API keys)
cp .env.example .env

# 3. Start all MCP servers (with auto-restart)
make run-servers

# 4. Start web inspector for debugging
make run-inspector

# 5. View inspector at the URL shown in the output

よくある使用例

特定の MCP サーバーをデバッグする

# Start inspector (will show URL with auth token)
make run-inspector
# Visit the URL shown in output to test MCP servers

新しい MCP サーバーを追加する

# Add GitHub MCP server
python mcp_servers.py add \
  --name github \
  --cmd npx \
  --args "-y @modelcontextprotocol/server-github" \
  --env GITHUB_TOKEN=your_token_here \
  --port 8094

Cursor AI で使用する

~/.cursor/mcp.json に追加します：

{
  "mcpServers": {
    "filesystem": { "url": "http://localhost:8090/sse" },
    "github": { "url": "http://localhost:8094/sse" },
    "brave-search": { "url": "http://localhost:8096/sse" }
  }
}

問題のあるサーバーを再起動する

# Kill conflicts and restart specific server
make restart-server SERVER=github

自動再起動なしで実行する（開発用）

make run-servers KEEP_ALIVE=0

自動で行われる処理

• 更新：起動前に npm パッケージと git リポジトリを確認、更新します
• ポートの競合：競合するプロセスを検出し、終了できます
• プロセスの監視：クラッシュしたサーバーを最大 3 回再起動します
• ログ：各サーバーのログを /tmp/<server_name>.log に記録します
• クリーンアップ：終了時にすべてのプロセスを適切に終了します

利用可能な MCP サーバー

デフォルト設定には、次のような人気のサーバーが含まれています：

• filesystem（8090）- ローカルファイルへのアクセス
• github（8094）- GitHub リポジトリとのやり取り
• brave-search（8096）- ウェブ検索
• fetch（8093）- HTTP リクエスト
• youtube（8092）- YouTube の検索／情報取得
• memory（8100）- 永続的なメモリ
• puppeteer（8101）- ウェブ自動化

トラブルシューティング

# Check what's using server ports
make check-server-ports

# Kill conflicting processes on server ports
make kill-server-conflicts

# Stop servers (inspector stops with Ctrl+C)
make stop-servers

# View server logs
tail -f /tmp/filesystem.log

設定

サーバーは mcp_config.json で定義します。環境変数には ${VAR} 構文を使用し、.env から読み込みます。

サーバー設定の例：

{
  "name": "github",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-github"], 
  "env": {"GITHUB_TOKEN": "${GITHUB_TOKEN}"},
  "port": 8094,
  "server_type": "stdio"
}