MCP Tools Cli

🚀 mcp-tools-cli ツール

このツールは、モデルコンテキストプロトコル（MCP）サーバーとやり取りするためのコマンドラインクライアントです。MCP サーバーとの通信を容易にし、様々な操作をコマンドラインから実行できます。

🚀 クイックスタート

このコマンドラインクライアントを使用することで、MCP サーバーとのやり取りをスムーズに行うことができます。以下に、基本的な使い方を説明します。

📦 インストール

mcp-tools-cli は pip を使って簡単にインストールできます。以下のコマンドを実行してください。

pip install mcp-tools-cli

📚 ドキュメント

設定

このクライアントは mcp_config.json という名前の設定ファイルを使用して、MCP サーバーへの接続情報を保存します。以下の内容を持つ mcp_config.json ファイルを作成してください。

{
  "mcpServers": {
    "time": {
      "command": "python",
      "args": ["-m", "mcp_server_time", "--local-timezone=America/New_York"]
    }
  }
}

これらの値を、あなた自身の MCP サーバー設定に置き換えてください。

使用方法

mcp-tools-cli <action> --mcp-name <mcp_name> [options]

引数

• action（必須）：実行する操作です。以下のいずれかを指定します。
  • list-tools：MCP サーバー上の利用可能なツールを一覧表示します。
  • call-tool：MCP サーバー上の特定のツールを呼び出します。
• --mcp-name（必須）：接続する MCP サーバーの名前です。mcp_config.json で定義された名前を指定します。
• --tool-name（call-tool 操作時に必須）：呼び出すツールの名前です。
• --tool-args（オプション）：ツールの引数です。JSON 文字列または単一の文字列値を指定できます。単一の文字列値が有効な JSON でない場合、それはツールの query 引数として渡されます。
• --config-path（オプション）：設定ファイル mcp_config.json のパスです。デフォルトは現在のディレクトリ内の mcp_config.json です。

設定ファイルの形式

設定ファイル mcp_config.json は以下の形式で記述します。

{
  "mcpServers": {
    "<mcp_name>": {
      "command": "<サーバーを実行するコマンド>",
      "args": ["<引数1>", "<引数2>", ...],
      "env": {
        "<環境変数名>": "<環境変数値>",
        ...
      }
    },
    ...
  }
}

<mcp_name> をあなたの MCP サーバー名（例：time）に置き換えてください。command、args、env フィールドはサーバーの実行方法を指定します。

例

時間 MCP サーバー を使用した例が mcp_config.sample.json に用意されています。これを使用する場合は、事前に pip install mcp-server-time を実行してください。

基本的な使用法

1. 利用可能なツールを一覧表示する

mcp-tools-cli list-tools --mcp-name time --config-path mcp_config.sample.json

2. get_current_time ツールを呼び出してクエリを渡す

mcp-tools-cli call-tool --mcp-name time --tool-name get_current_time --config-path mcp_config.sample.json

エラー処理

エラーが発生した場合、クライアントはコンソールにエラーメッセージを表示します。例えば以下のようなエラーがあります。

• FileNotFoundError：設定ファイルが見つからない場合。
• json.JSONDecodeError：設定ファイルが有効な JSON ファイルでない場合。
• ValueError：設定ファイルに MCP サーバーが見つからない、またはコマンドが不足している場合。
• argparse.ArgumentError：無効なコマンドライン引数が指定された場合。
• その他、ツールの実行中に発生する例外。