mcp-chat

开源通用MCP客户端，用于测试及评估MCP服务器与代理

快速入门指南

请确保已将ANTHROPIC_API_KEY环境变量导出到系统环境中，或在项目根目录下的.env文件中设置。您可以在Anthropic控制台密钥页面注册并获取API密钥。

简单的用例：从命令行启动一个带有文件系统MCP服务器的交互式聊天提示：

npx mcp-chat --server "npx -y @modelcontextprotocol/server-filesystem /Users/$USER/Desktop"

这将打开一个聊天提示，您可以用于与服务器交互并使用LLM进行对话。

配置

您还可以通过指定claude_desktop_config.json文件（Mac系统）来配置：

npx mcp-chat --config "/Users/你的用户名/.config/autocad/acad2018/chloroform/chain"

Windows系统则为：

npx mcp-chat --config "C:\Users\你的用户名\AppData\Roaming\AutoCAD\\2018\ChloroForm\Chain"

网页模式

通过--web标志启动网页模式，您可以在浏览器中使用：

npx mcp-chat --web

请确保已设置ANTHROPIC_API_KEY环境变量。

功能特性

• 交互式聊天：支持从命令行发起对话。
• 连接任何MCP服务器：可与任意MCP服务器建立连接。
• 支持多种模型：兼容不同LLM模型。
• 上下文感知：具备上下文理解能力，对话更连贯。

详细使用说明

命令行选项

npx mcp-chat [选项]

可用选项：

• --server, -s：指定MCP服务器地址，默认为http://localhost:8080。
• --web, -w：启动网页模式，在浏览器中使用。
• --config, -c：指定配置文件路径。
• --version, -v：显示当前版本号。
• --help, -h：显示帮助信息。

示例用法

1. 从命令行发起对话：

npx mcp-chat --server http://localhost:8080 -p "列出桌面目录下的文件"

2. 启动网页模式：

npx mcp-chat --web

开发者指南

连接MCP服务器进行测试

在开发MCP服务器时，可以通过以下命令测试mcp-chat：

Node.js环境

npm install @modelcontextprotocol/server-file-system
node -e "require('@modelcontextprotocol/server-file-system').start(8080)"

然后使用mcp-chat发起对话：

npx mcp-chat --server http://localhost:8080 -p "列出桌面目录下的文件"

Python环境

安装Python依赖：

pip install modelcontextprotocol-server-file-system
python3 -m modelcontextprotocol.server_file_system.start 8080

然后使用mcp-chat发起对话：

npx mcp-chat --server http://localhost:8080 -p "列出桌面目录下的文件"

项目架构

├── src/
│   ├── index.ts            # 主客户端实现与CLI参数处理
│   ├── constants.ts        # 默认常量定义
│   └── interactive.ts      # 交互式聊天提示逻辑
└── test/                   # 测试文件夹
    ├── cli.test.ts         # CLI参数测试
    └── config.test.ts      # 配置文件解析测试

发布新版本

访问Github发布页面，点击“新建发布”按钮，选择“添加标签”，创建新的语义化版本号v{主版本}.{次版本}.{修订版本}。填写发布标题“发布v{主版本}.{次版本}.{修订版本}”及变更日志，点击“发布”。

无需手动更新package.json中的版本号，因为GitHub工作流会自动处理并推送到主线分支。

许可证

MIT许可证