mcp-tools-cli

mcp-tools-cli

これは、Model Context Protocol（MCP）サーバーとやり取りするためのコマンドラインクライアントです。

インストール

mcp-tools-cli は pip を使ってインストールできます。

pip install mcp-tools-cli

設定

クライアントは、MCP サーバーの接続情報を保存するために、mcp_config.json という名前の設定ファイルを使用します。次の内容で 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_config.json で定義された、接続先の MCP サーバー名です。
• --tool-name（call-tool アクションでは必須）：呼び出すツールの名前です。
• --tool-args（任意）：ツールに渡す引数です。JSON 文字列または単一の文字列値を指定できます。単一の文字列値が有効な JSON でない場合、ツールの query 引数として渡されます。
• --config-path（任意）：mcp_config.json ファイルへのパスです。デフォルトでは、現在のディレクトリにある mcp_config.json が使用されます。

設定

クライアントは、MCP サーバーの接続情報を保存するために、mcp_config.json という名前の設定ファイルを使用します。ファイルは次の形式にしてください。

{
  "mcpServers": {
    "<mcp_name>": {
      "command": "<command to run the server>",
      "args": ["<argument1>", "<argument2>", ...],
      "env": {
        "<environment variable name>": "<environment variable value>",
        ...
      }
    },
    ...
  }
}

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

例

Time MCP Server を使用するサンプルは、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：無効なコマンドライン引数が指定された場合。
• ツールの実行中に発生したその他の例外。