🌟 MCPM - Model Context Protocol Manager

English | 简体中文

Open Source. Forever Free.
Built with ❤️ by Path Integral Institute

🌟 MCPM - Model Context Protocol Manager

MCPM は、MCP サーバーを管理するためのオープンソースの CLI ツールです。サーバーを一度インストールしてプロファイルで整理し、任意の MCP クライアントに連携できる、シンプルなグローバル設定方式を提供します。主な機能には、中央レジストリを通じたサーバーの検索、直接実行、共有機能、クライアント連携ツールなどがあります。

デモでは古い v1 コマンドを使用しています。新しいデモを準備中です……

🤝 コミュニティからの貢献

💡 MCP エコシステムを成長させましょう！ MCP Registry への貢献を歓迎します。独自のサーバーを追加したり、ドキュメントを改善したり、機能を提案したりしてください。オープンソースはコミュニティの参加によって発展します！

🚀 クイックインストール

推奨：

curl -sSL https://mcpm.sh/install | bash

または、brew、pipx、uv などのその他のインストール方法を選択してください。

🔎 概要

MCPM v2.0 は、グローバル設定モデルにより、MCP サーバーを簡単に管理できます。主な機能は次のとおりです。

• ✨ グローバルサーバー管理：サーバーを一度インストールすれば、どこでも使用できます
• 📋 仮想プロファイル：タグを使って、さまざまなワークフロー向けにサーバーを整理できます
• 🔍 サーバー検索：MCP Registry を閲覧してサーバーをインストールできます
• 🚀 直接実行：テスト用に stdio または HTTP 経由でサーバーを実行できます
• 🌐 公開共有：セキュアなトンネルを通じてサーバーを共有できます
• 🔄 サーバーの更新：Git ベース、NPX、バイナリのサーバーの更新を確認して適用できます
• 🎛️ クライアント連携：Claude Desktop、Cursor、Windsurf などの設定を管理できます
• 🤖 AI エージェントに適した設計：llm.txt ガイドを備えた、包括的な自動化をサポートする非対話型 CLI
• 💻 美しい CLI：リッチな書式設定とインタラクティブなインターフェース
• 📊 利用状況分析：サーバーの使用状況とパフォーマンスを監視できます

MCPM v2.0 では、v1 のターゲットベースのシステムの複雑さをなくし、シンプルなグローバルワークスペースモデルを採用しています。

🖥️ 対応 MCP クライアント

MCPM は、次のクライアント向けに MCP サーバー管理をサポートする予定です。

• 🤖 Claude Desktop（Anthropic）
• ⌨️ Cursor
• 🏄 Windsurf
• 🧩 Vscode
• 📝 Cline
• ➡️ Continue
• 🦢 Goose
• 🔥 5ire
• 🦘 Roo Code
• 💻 OpenCode
• ✨ 今後、さらに多くのクライアントに対応予定……

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

MCPM は、すっきり整理されたインターフェースを備えた包括的な CLI を提供します。v2.0 のアーキテクチャでは、サーバーを一度インストールしてプロファイルで整理し、必要に応じて特定の MCP クライアントに連携できるグローバル設定モデルを採用しています。

ℹ️ 一般

mcpm --help          # Display help information and available commands
mcpm --version       # Display the current version of MCPM

🌐 サーバー管理

グローバルなサーバーのインストールと管理コマンド：

# 🔍 Search and Install
mcpm search [QUERY]           # Search the MCP Registry for available servers
mcpm info SERVER_NAME         # Display detailed information about a server
mcpm install SERVER_NAME      # Install a server from registry to global configuration
mcpm uninstall SERVER_NAME    # Remove a server from global configuration

# 📋 List and Inspect
mcpm ls                       # List all installed servers and their profile assignments
mcpm edit SERVER_NAME         # Edit a server configuration
mcpm inspect SERVER_NAME      # Launch MCP Inspector to test/debug a server

🚀 サーバーの実行

テストまたは連携のためにサーバーを直接実行します。

mcpm run SERVER_NAME          # Execute a server directly over stdio
mcpm run SERVER_NAME --http   # Execute a server over HTTP for testing
mcpm share SERVER_NAME        # Share a server through secure tunnel for remote access
mcpm usage                    # Display comprehensive analytics and usage data

📂 プロファイル管理

プロファイルは、さまざまなワークフローに合わせてサーバーを論理的なグループに整理する仮想タグです。

# 🔄 Profile Operations
mcpm profile ls               # List all profiles and their tagged servers
mcpm profile create PROFILE   # Create a new profile
mcpm profile rm PROFILE       # Remove a profile (servers remain installed)
mcpm profile edit PROFILE     # Interactive server selection for profile

# 🚀 Profile Execution
mcpm profile run PROFILE      # Execute all servers in a profile over stdio or HTTP
mcpm profile share PROFILE    # Share all servers in a profile through secure tunnel
mcpm profile inspect PROFILE  # Launch MCP Inspector for all servers in profile

🖥️ クライアント連携

MCP クライアントの設定（Claude Desktop、Cursor、Windsurf など）を管理します。

mcpm client ls                 # List all supported MCP clients and their status
mcpm client edit CLIENT_NAME   # Interactive server enable/disable for a client
mcpm client edit CLIENT_NAME -e # Open client config in external editor
mcpm client import CLIENT_NAME  # Import server configurations from a client

🔄 サーバーの更新

インストール済みの MCP サーバーの更新を確認し、適用します。

mcpm update                   # Update all servers
mcpm update SERVER_NAME       # Update a specific server
mcpm update --check           # Dry run — check for updates without applying
mcpm update --rebase          # Use git rebase instead of fast-forward
mcpm update --init            # Scan servers and populate source metadata
mcpm update --init --force    # Re-detect all source metadata

MCPM は各サーバーの入手元（git リポジトリ、npm パッケージ、HTTP リモート）を追跡し、最新の変更を自動で取得できます。git ベースのサーバーは、デフォルトで git pull --ff-only を使って更新されます。オプションとして --rebase も選択できます。NPX/UVX サーバーは実行時に自動更新され、情報提供のみを目的として表示されます。

🛠️ システムと設定

mcpm doctor                   # Check system health and server status
mcpm config                   # Manage MCPM configuration and settings
mcpm migrate                  # Migrate from v1 to v2 configuration

📚 レジストリ

MCP レジストリは、MCPM を使ってインストールできる MCP サーバーの中央リポジトリです。レジストリは mcpm.sh/registry で利用できます。

🤖 AI エージェントとの連携

MCPM は AI エージェントに適した設計で、包括的な自動化をサポートします。すべての対話型コマンドには、CLI パラメーターと環境変数を使った非対話型の代替手段があります。

🔧 非対話型モード

環境変数を設定すると、完全な自動化を有効にできます。

export MCPM_NON_INTERACTIVE=true  # Disable all interactive prompts
export MCPM_FORCE=true            # Skip confirmations
export MCPM_JSON_OUTPUT=true      # JSON output for parsing

📋 LLM.txt ガイド

llm.txt ファイルには、AI エージェント向けに特化した包括的なドキュメントが記載されています。以下の内容を含みます。

• パラメーターと使用例を含む、完全なコマンドリファレンス
• 環境変数の使用パターン
• 自動化のベストプラクティス
• エラー処理とトラブルシューティング
• バッチ操作のパターン

llm.txt ファイルは CLI の構造から自動生成され、リリースごとに最新の状態に保たれます。

⚡ 使用例

ユースケース 1：ローカルの stdio サーバーを HTTP 経由で公開する

1. サーバーを MCPM に追加します。

mcpm new [MY_SERVER_NAME] --type stdio --command "[COMMAND]" --args "[ARG_1] [ARG_2] ..."

（確認の対話を省略するには、--force 引数を追加します） インストール済みサーバーに表示されることを確認します。

mcpm ls

一覧に [MY_SERVER_NAME] が表示されます。

2. HTTP 経由で提供します。

mcpm run [MY_SERVER_NAME] --http

MCPM がサーバーの URL を出力します。例：

URL: http://127.0.0.1:6276/mcp/

3. ネットワーク上に公開します（任意）。

mcpm run [MY_SERVER_NAME] --http --host 0.0.0.0

ヒント：別のポートを指定するには、--port <PORT> を追加します。

ユースケース 2：複数のサーバーを組み合わせ、1 つのプロファイルとして提供する

1. サーバーを MCPM に追加します。

# Stdio server
mcpm new [SERVER_A] --type stdio --command "[COMMAND]" --args "[ARG_1] [ARG_2] ..." --force

# Remote HTTP/SSE server
mcpm new [SERVER_B] --type remote --url "http://SERVER_ADDR/mcp/" --force

2. プロファイルを作成し、サーバーを追加します。 対話型：

mcpm profile create [PROFILE_NAME]
mcpm profile edit [PROFILE_NAME]

MCPM にインストール済みのサーバーがすべて一覧表示されます。矢印キーで移動し、スペースキーで選択／選択解除、入力して検索し、Enter キーで確定できます。

確認：

mcpm profile ls

選択したサーバーを含むプロファイルが表示されます。

3. プロファイルを実行します。

# Stdio
mcpm profile run [PROFILE_NAME]

# HTTP
mcpm profile run [PROFILE_NAME] --http

# Optional: host and port
mcpm profile run [PROFILE_NAME] --http --host 0.0.0.0 --port 8080

その他の一般的な使い方

# Server management
mcpm new myserver --type stdio --command "python -m server" --force
mcpm edit myserver --env "API_KEY=secret" --force

# Profile management  
mcpm profile edit web-dev --add-server myserver --force
mcpm profile run web-dev --port 8080

# Client integration
mcpm client edit cursor --add-profile web-dev --force

🗺️ ロードマップ

✅ v2.0 完了

• グローバルサーバー設定モデル
• プロファイルベースのサーバータグ付けと整理
• 対話型コマンドインターフェース
• クライアント連携管理（mcpm client edit）
• 一貫した UX を備えた最新の CLI
• レジストリ連携とサーバーの検索
• サーバーの直接実行と共有
• 既存のクライアント設定からのインポート
• 追加のクライアントサポート（gemini-cli、codex など）

🔮 今後の拡張

• サーバー更新管理（mcpm update）
• GitHub リリースバイナリの更新（ダウンロード＋置き換え）
• 高度なサーバーアクセスの監視と分析
• Docker での実行
• MCPM の機能を MCP サーバーとして公開（検索、インストール、プロファイル管理など）
• MCP inspect 用 TUI インターフェース
• MCP とプロファイル管理用 TUI インターフェース

📦 その他のインストール方法

🍺 Homebrew

brew install mcpm

📦 pipx（Python ツールにおすすめ）

pipx install mcpm

🪄 uv tool

uv tool install mcpm

その他のインストール方法

🐍 pip

pip install mcpm

🧰 X-CMD

x-cmd のユーザーは、次のコマンドを実行できます。

x install mcpm.sh

👨‍💻 開発

このリポジトリには、最新のパッケージ開発プラクティスに従い、Python と Click で構築された MCP Manager の CLI とサービスコンポーネントが含まれています。

📋 開発要件

• 🐍 Python 3.10+
• 🚀 uv（仮想環境と依存関係の管理用）
• 🖱️ CLI 用の Click フレームワーク
• ✨ コンソール出力を強化する Rich
• 🌐 API とのやり取りに使用する Requests

📁 プロジェクト構成

このプロジェクトでは、モダンな src ベースのレイアウトを採用しています。

mcpm.sh/
├── src/             # Source package directory
│   └── mcpm/        # Main package code
├── tests/           # Test directory
├── test_cli.py      # Development CLI runner
├── pyproject.toml   # Project configuration
├── pages/           # Website content
│   └── registry/    # Registry website
├── mcp-registry/    # MCP Registry data
└── README.md        # Documentation

🚀 開発環境のセットアップ

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

   git clone https://github.com/pathintegral-institute/mcpm.sh.git
   cd mcpm.sh
   

2. uv で仮想環境をセットアップします

   uv venv --seed
   source .venv/bin/activate  # On Unix/Mac
   

3. 開発モードで依存関係をインストールします

   uv pip install -e .
   

4. 開発中に CLI を直接実行します

   # Either use the installed package
   mcpm --help
   
   # Or use the development script
   ./test_cli.py --help
   

5. テストを実行します

   pytest tests/
   

✅ ベストプラクティス

• 📁 インポートの混乱を防ぐため、src ベースのディレクトリ構成を使用します
• 🔧 uv pip install -e . を使った編集可能インストールで開発します
• 🧩 コマンドは src/mcpm/commands/ ディレクトリ内でモジュール化します
• 🧪 新機能のテストを tests/ ディレクトリに追加します
• 💻 開発時の簡易テストには test_cli.py スクリプトを使用します

🔢 バージョン管理

MCP では、すべてのコンポーネント間で一貫性を保つために、バージョン管理に単一の信頼できる情報源のパターンを採用しています。

🏷️ バージョン構成

• 📍 正式なバージョンは、プロジェクトルートの version.py で定義されています
• 📥 src/mcpm/__init__.py がこのバージョンをインポートします
• 📄 pyproject.toml は動的バージョン管理を使用して version.py から読み込みます
• 🏷️ Git タグは、同じバージョン番号の先頭に「v」を付けて作成します（例：v1.0.0）

🔄 バージョンの更新

新しいバージョンをリリースする場合：

1. 提供されているバージョン更新スクリプトを使用します

   ./bump_version.sh NEW_VERSION
   # Example: ./bump_version.sh 1.1.0
   

2. 変更内容とタグをプッシュします

   git push && git push --tags
   

3. 新しいバージョンに一致する GitHub リリースを作成します

この手順により、コード、パッケージメタデータ、Git タグのすべてでバージョンの一貫性が保たれます。 PyPI へのリリースは CI/CD パイプラインで処理され、自動的に開始されます。

📜 ライセンス

MIT

Star History