mcpField
M
mcp-cli

mcp-cli

github.com/wong2フレームワーク・SDK44720 週間前に更新

mcp-cli について

mcp-cli は Model Context Protocol 向けのコマンドラインインスペクターで、MCP サーバーへの接続と内容の確認に使用します。対話操作やスクリプトからサーバーを検証したい開発者に向いています。

主な機能

  1. 01複数のソースから MCP サーバーを起動
  2. 02ツール、リソース、プロンプトの一覧表示
  3. 03ツールの呼び出しとリソース、プロンプトの読み取り
  4. 04SSE と Streamable HTTP 向けの OAuth 対応
  5. 05スクリプト連携用の非対話モード

活用シーン

  1. 01ローカルで開発中の MCP サーバーをターミナルからデバッグ
  2. 02自動化スクリプトによるツールの一括呼び出し
  3. 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

関連情報

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。