MCP Tools Cli

🚀 mcp-tools-cli Tool

This is a command-line client for interacting with the Model Context Protocol (MCP) server. It simplifies the process of communicating with MCP servers, enabling users to perform various operations efficiently.

🚀 Quick Start

📦 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 connection information for the MCP server. Create a file 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 configuration.

💻 Usage Examples

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

📋 Parameters

• action (Required): The operation to perform. It must be one of the following:
  • list-tools: List the available tools on the MCP server.
  • call-tool: Call 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 when the action is call-tool): The name of the tool to call.
• --tool-args (Optional): The arguments for the tool. It can be a JSON string or a single string value. If the single string value is not valid JSON, it will be passed as the query parameter of the tool.
• --config-path (Optional): The path to the configuration file mcp_config.json. The default is mcp_config.json in the current directory.

⚙️ Configuration Details

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

{
  "mcpServers": {
    "<mcp_name>": {
      "command": "<Command to run the server>",
      "args": ["<Argument 1>", "<Argument 2>", ...],
      "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

An example using the Time MCP Server is provided in mcp_config.sample.json. If you wish to use it, 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 and pass a query:

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

❌ Error Handling

If any errors occur, the client will print an error message on the console, for example:

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