mcp-tools-cli

This is a command-line client for interacting with Model Context Protocol (MCP) servers.

Installation

You can install mcp-tools-cli using pip:

pip install mcp-tools-cli

Configuration

The client uses a configuration file named mcp_config.json to store the connection details for MCP servers. Create a file named mcp_config.json with the following content:

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

Replace the values with your own MCP server configurations.

Usage

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

Arguments

• action (required): The action to perform. Must be one of:
  • list-tools: Lists the available tools on the MCP server.
  • call-tool: Calls a specific tool on the MCP server.
• --mcp-name (required): The name of the MCP server to connect to, as defined in mcp_config.json.
• --tool-name (required for call-tool action): The name of the tool to call.
• --tool-args (optional): Arguments for the tool. Can be a JSON string or a single string value. If a single string value is not a valid JSON, it will be passed as the query argument to the tool.
• --config-path (optional): Path to the mcp_config.json file. Defaults to mcp_config.json in the current directory.

Configuration

The client uses a configuration file named mcp_config.json to store the connection details for MCP servers. The file should be in the following format:

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

Replace <mcp_name> with the name of your MCP server (e.g., time). The command, args, and env fields specify how to run the server.

Examples

A sample using the Time MCP Server is provided in mcp_config.sample.json. If you want to use this, please execute pip install mcp-server-time beforehand.

1. List available tools:

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

2. Call the get_current_time tool with a query:

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

Error Handling

The client will print error messages to the console if any errors occur, such as:

• FileNotFoundError: If the config file is not found.
• json.JSONDecodeError: If the config file is not a valid JSON file.
• ValueError: If the MCP server is not found in the config file, or if the command is missing.
• argparse.ArgumentError: If there are invalid command-line arguments.
• Other exceptions during tool execution.