MCP 终端客户端

April 6, 2025 · View on GitHub

基于 Rich 和 Typer 的 MCP（Model Context Protocol）客户端终端应用，支持多服务器连接和配置文件管理。

功能特点

git clone https://github.com/martin666888/mcp_client.git
cd mcp_client

pip install -r requirements.txt

或使用 uv（更快的包管理器）：

uv pip install -r requirements.txt

将 config.json.template 复制为 config.json 并填入您的 API 密钥和其他配置信息：

cp config.json.template config.json

将 config.py.template 复制为 config.py 并填入您的 OpenAI API 密钥：

cp config.py.template config.py

启动交互式聊天：

python mcp_terminal.py

或

python mcp_terminal.py chat

连接到 MCP 服务器：
```
python mcp_terminal.py connect --from-config <服务器ID>
```
或在聊天模式中：
```
!connect --from-config <服务器ID>
```
重要提示： 当前程序只能使用以下两种方式连接服务器：
1. 使用配置文件方式：!connect --from-config <服务器ID>
2. 使用单个 npx 命令：!connect npx <参数>
目前不支持复合命令形式，如 !connect uvx mcp-server-fetch。请使用配置文件方式代替。
查看配置文件中的服务器：
```
python mcp_terminal.py config --list
```
或在聊天模式中：
```
!config --list
```
管理对话历史记录：
```
python mcp_terminal.py history
```
或在聊天模式中：
```
!history
```
清除对话历史记录：
```
python mcp_terminal.py clear
```
或在聊天模式中：
```
!clear
```

config.json 文件格式如下：

{
  "mcpServers": {
    "server-id": {
      "command": "命令",
      "args": ["参数1", "参数2"],
      "env": {
        "ENV_VAR": "值"
      }
    }
  }
}

欢迎提交 Pull Request 或创建 Issue 来改进这个项目！