MCP Chat

🚀 mcp-chat

mcp-chat 是一个开源通用的 MCP 客户端，主要用于对 MCP 服务器与代理进行测试和评估，能帮助开发者高效验证相关服务的性能与功能。

🚀 快速开始

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

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

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

执行上述命令后，会打开一个聊天提示界面，您可以通过它与服务器交互，并使用大语言模型（LLM）进行对话。

✨ 主要特性

• 交互式聊天：支持从命令行发起对话，方便快捷。
• 连接任何 MCP 服务器：可以与任意 MCP 服务器建立连接，具有良好的兼容性。
• 支持多种模型：兼容不同的大语言模型（LLM），满足多样化需求。
• 上下文感知：具备上下文理解能力，让对话更加连贯自然。

📦 安装指南

本项目无需复杂的安装步骤，通过npx命令即可直接使用。前提是要完成ANTHROPIC_API_KEY环境变量的设置。

💻 使用示例

基础用法

从命令行发起对话：

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

高级用法

配置文件使用

您可以通过指定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环境变量。

📚 详细文档

命令行选项

npx mcp-chat [选项]

可用选项如下：

🔧 技术细节

项目架构

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

开发者指南

连接 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 "列出桌面目录下的文件"

📄 许可证

本项目采用MIT 许可证。

发布新版本

访问Github 发布页面，点击“新建发布”按钮，选择“添加标签”，创建新的语义化版本号v{主版本}.{次版本}.{修订版本}。填写发布标题“发布 v{主版本}.{次版本}.{修订版本}”及变更日志，最后点击“发布”。无需手动更新package.json中的版本号，因为 GitHub 工作流会自动处理并推送到主线分支。