MCP Client

MCP 客户端

用于与 Anthropic 的 Claude 模型交互的命令行工具，使用 MCP（Model Context Protocol）服务。

功能

• 连接到配置文件中定义的多个 MCP 服务
• 使用可用的 MCP 工具与 Claude 进行交互式聊天
• 实时流式传输 Claude 的响应
• 支持交互式和单次查询两种模式
• 清晰格式的丰富终端输出

安装

# Clone the repository
git clone https://github.com/lingster/mcp-llm.git
cd mcp-llm

# Install with uv
uv sync 

配置

创建一个 JSON 配置文件来定义你的 MCP 服务。例如：

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "your-api-key-here"
      }
    }
  }
}

将此文件保存到以下位置之一：

• ~/.config/mcp-client/config.json
• ~/.mcp-client.json
• ./mcp-client.json
• ./config.json

或者，你可以使用 --config 选项指定自定义配置文件。

使用

交互式聊天

# Start interactive chat with all configured servers
uv run mcpllm chat

# Connect to specific servers only
uv run mcpllm chat --server brave-search 

# Use a custom configuration file
uv run mcpllm chat --config /path/to/config.json

# Customize Claude model and parameters
uv run mcpllm chat --model claude-3-5-sonnet-20241022 --temperature 0.8 --max-tokens 8192

单次查询模式

# Process a single query and exit
uv run mcpllm chat --query "Is it raining in London?"

# tool use
uv run mcpllm chat --server brave-search --query "Where's wally?"

列出已配置的服务

# Show all configured servers
mcpllm servers

环境变量

• ANTHROPIC_API_KEY：你的 Anthropic API 密钥（必需）

你也可以在当前目录中创建一个 .env 文件：

ANTHROPIC_API_KEY=your-api-key-here

许可证

MIT