MCPGod

MCPGod

モデルコンテキストプロトコル（MCP）のクライアント、サーバー、ツールをきめ細かく制御できます。コンテキストこそがすべてです。

概要

MCPGod は、開発者が MCP サーバーをすばやく簡単に管理できるように設計された CLI ツールです。サーバーの追加、実行、一覧表示、削除はもちろん、サーバーのツールとのやり取りにも対応しており、Windows、macOS、Linux でこれらすべての作業を効率的に行えます。

特長

• クライアント管理
  特定のクライアント向けに MCP サーバーを追加、削除、一覧表示できます。
• ツールの検出 任意の MCP サーバー上のすべてのツールを一覧表示します。
• ツールの呼び出し コマンドラインから任意の MCP サーバー上のツールを実行できます。
• ツール／クライアントの権限 特定のクライアントに対して、特定のツールを許可またはブロックできます。
• 詳細なログ記録 すべてのクライアントから実行されたサーバーのログをタイムスタンプ付きで記録し、デバッグしやすいように見やすく出力します。

インストール

npm を使って mcpgod をグローバルにインストールします。

npm install -g mcpgod

インストールを確認します。

mcpgod --version

または、npx で直接実行します。

npx -y mcpgod

使い方

mcpgod コマンド（または npx -y mcpgod）で CLI にアクセスできます。以下に一般的な使用例を示します。

• クライアントにサーバーを追加する

  mcpgod add <SERVER> -c <CLIENT> を使って、MCP サーバーをクライアント（例：Claude）に追加します。

  mcpgod add @modelcontextprotocol/server-everything -c claude
  

• 特定のツールのみをクライアントに追加する

  mcpgod add <SERVER> -c <CLIENT> --tools=<COMMA_DELIMITED_LIST> を使って、特定のツールのみをクライアントに追加します。

  mcpgod add @modelcontextprotocol/server-everything -c claude --tools=echo,add
  

• クライアントのサーバーを一覧表示する

  mcpgod list -c <CLIENT> を使って、特定のクライアントに設定されているすべてのサーバーを一覧表示します。

  mcpgod list -c claude
  

• サーバーを削除する

  mcpgod remove <SERVER> -c <CLIENT> を使って、クライアントの設定から MCP サーバーを削除します。

  mcpgod remove @modelcontextprotocol/server-everything -c claude
  

• サーバーを実行する

  mcpgod run <SERVER> を使って、詳細なログを記録しながらサーバープロセスを実行します。

  mcpgod run @modelcontextprotocol/server-everything
  mcpgod run ./mcp-server.py
  mcpgod run ./mcp-server-node.mjs
  

• サーバーで利用可能なツールを一覧表示する

  mcpgod tools <SERVER> を使って、サーバーで利用可能なツールの一覧を表示します。

  mcpgod tools @modelcontextprotocol/server-everything
  mcpgod tools ./mcp-server.py
  mcpgod tools ./mcp-server-node.mjs
  

• サーバー上の特定のツールを呼び出す

  mcpgod tool <SERVER> <TOOL> [optional parameters] を使って、キーと値のプロパティを渡し、ツールを操作します。

  mcpgod tool @modelcontextprotocol/server-everything add a=59 b=40
  mcpgod tool ./mcp-server.py echo message=hi
  mcpgod tool ./mcp-server-node.mjs echo message=hi
  

コマンドとオプションの一覧をすべて確認するには、次を実行します。

mcpgod --help

ログ記録

サーバーの実行時、mcpgod は次の場所に出力を記録します。

~/mcpgod/logs

各ログファイルはサーバー名ごとに整理され、発生した問題を追跡してデバッグしやすいよう、タイムスタンプが付与されます。

開発

mcpgod は Oclif フレームワークで構築されており、MCP サーバーと堅牢にやり取りするために Model Context Protocol SDK を使用しています。

開発を始めるには、リポジトリをクローンします。

git clone https://github.com/mcpgod/cli.git
cd mcpgod
npm install

開発モードで CLI を実行します。

./bin/dev

公開

自動公開は version, tag and github release ワークフローによって処理されます。main ブランチにバージョン更新がマージされると、新しい npm バージョンが公開されます。このワークフローは Actions タブから手動で実行することもできます。

公開を有効にするには、次のリポジトリシークレットを設定します。

• NPM_TOKEN – npm の認証トークンです。
• GH_EMAIL と GH_USERNAME – README の更新ステップで使用されます。

シークレットを設定した後、新しいバージョンをプッシュするか、ワークフローを手動で実行すると、プロジェクトがビルドされ、GitHub リリースが作成され、パッケージが npm に公開されます。

ワークフローのリンティング

ワークフローの変更をコミットする前に、ローカルでリンティングできます。

npm run lint:workflows

貢献

貢献をいつでも歓迎します！貢献するには、次の手順に従ってください。

1. リポジトリをフォークします。
2. ブランチを作成します：

   git checkout -b feature/your-feature
   

3. 変更を加え、コミットします：

   git commit -am 'Add new feature'
   

4. ブランチをプッシュします：

   git push origin feature/your-feature
   

5. GitHub でプルリクエストを作成します。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。

---

追加リソース

• Oclif CLI Framework
• Model Context Protocol
• npm Package mcpgod

---