mcp-cli

MCP-CLI

コマンドラインから MCP サーバーにアクセスします。MCP を使用すると、外部システム、ファイルシステム、データベース、API などとの連携が可能になります。

コマンド

コマンド	出力
mcp-cli	すべてのサーバーとツール名を一覧表示
mcp-cli <server>	パラメータ付きのツールを表示
mcp-cli <server>/<tool>	ツールの JSON スキーマを取得
mcp-cli <server>/<tool> '<json>'	引数を指定してツールを呼び出す
mcp-cli grep "<glob>"	名前でツールを検索

-d を追加すると説明が含まれます (例: mcp-cli filesystem -d)

ワークフロー

1. 検出: mcp-cli → 利用可能なサーバーとツールを確認
2. 探索: mcp-cli <server> → パラメータ付きのツールを確認
3. 調査: mcp-cli <server>/<tool> → 完全な JSON 入力スキーマを取得
4. 実行: mcp-cli <server>/<tool> <json>' → 実行

例

# List all servers and tool names
mcp-cli

# See all tools with parameters
mcp-cli filesystem

# With descriptions (more verbose)
mcp-cli filesystem -d

# Get JSON schema for specific tool
mcp-cli filesystem/read_file

# Call the tool
mcp-cli filesystem/read_file '{"path": "./README.md"}'

# Search for tools
mcp-cli grep "*file*"

# JSON output for parsing
mcp-cli filesystem/read_file '{"path": "./README.md"}' --json

# Complex JSON with quotes (use heredoc or stdin)
mcp-cli server/tool <<EOF
{"content": "Text with 'quotes' inside"}
EOF

# Or pipe from a file/command
cat args.json | mcp-cli server/tool

# Find all TypeScript files and read the first one
mcp-cli filesystem/search_files '{"path": "src/", "pattern": "*.ts"}' --json | jq -r '.content[0].text' | head -1 | xargs -I {} sh -c 'mcp-cli filesystem/read_file "{\"path\": \"{}\"}"'

オプション

フラグ	目的
-j, --json	スクリプト用の JSON 出力
-r, --raw	生のテキストコンテンツ
-d	説明を含める

終了コード

• 0: 成功
• 1: クライアントエラー (不正な引数、設定)
• 2: サーバーエラー (ツールの失敗)
• 3: ネットワークエラー