mcp-cli について
mcp-cli は Model Context Protocol 向けのコマンドラインインスペクターで、MCP サーバーへの接続と内容の確認に使用します。対話操作やスクリプトからサーバーを検証したい開発者に向いています。
主な機能
- 01複数のソースから MCP サーバーを起動
- 02ツール、リソース、プロンプトの一覧表示
- 03ツールの呼び出しとリソース、プロンプトの読み取り
- 04SSE と Streamable HTTP 向けの OAuth 対応
- 05スクリプト連携用の非対話モード
活用シーン
- 01ローカルで開発中の MCP サーバーをターミナルからデバッグ
- 02自動化スクリプトによるツールの一括呼び出し
- 03保存された OAuth トークンなどのローカルデータの削除
MCP 対応
本プロジェクトは MCP クライア兼インスペクターとして、stdio、SSE、Streamable HTTP を介して MCP サーバーに接続し、そのツール、リソース、プロンプトを参照します。
詳細
mcp-cli
Model Context Protocol 用の CLI インスペクター
https://github.com/user-attachments/assets/4cd113e9-f097-4c9d-b391-045c5f213183
機能
- さまざまなソースから MCP サーバーを実行
- ツール、リソース、プロンプトを一覧表示
- ツールの呼び出し、リソースの読み取り、プロンプトの読み取り
- SSE および Streamable HTTP サーバー向けの OAuth サポート
使用方法
引数なしで実行
npx @wong2/mcp-cli
Claude Desktop の設定ファイルが使用されます。
設定ファイルを指定して実行
npx @wong2/mcp-cli -c config.json
設定ファイルの形式は Claude Desktop の設定ファイルと同じです。
NPM からサーバーを実行
npx @wong2/mcp-cli npx <package-name> <args>
サーバーが現在のシェルの環境変数を必要とする場合は、--pass-env を追加してください。
ローカルで開発したサーバーを実行
npx @wong2/mcp-cli node path/to/server/index.js args...
サーバーが現在のシェルの環境変数を必要とする場合は、--pass-env を追加してください。
Streamable HTTP 経由で実行中のサーバーに接続
npx @wong2/mcp-cli --url http://localhost:8000/mcp
SSE 経由で実行中のサーバーに接続
npx @wong2/mcp-cli --sse http://localhost:8000/sse
非対話モード
対話形式のプロンプトを表示せずに、特定のツール、リソース、またはプロンプトを実行します。
npx @wong2/mcp-cli [--config config.json] <command> <server-name>:<target> [--args '{}']
例:
# Call a tool without arguments
npx @wong2/mcp-cli -c config.json call-tool filesystem:list_files
# Call a tool with arguments
npx @wong2/mcp-cli -c config.json call-tool filesystem:read_file --args '{"path": "package.json"}'
# Read a resource
npx @wong2/mcp-cli -c config.json read-resource filesystem:file://system/etc/hosts
# Use a prompt
npx @wong2/mcp-cli -c config.json get-prompt filesystem:create_summary --args '{"text": "Hello world"}'
このモードは、対話形式のプロンプトをすべて省略し、指定されたプリミティブを直接実行するため、スクリプトや自動化に便利です。
保存済みデータ(OAuth トークンなど)を削除
npx @wong2/mcp-cli purge
関連情報
- mcpservers.org - MCP サーバーを厳選した一覧
コメント
Markdown 対応
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。