MCP Chat Desktop App

基本能力

产品定位

chat-mcp 是一个跨平台的桌面应用程序，用于连接和交互各种大型语言模型（LLMs），旨在为开发者和研究人员提供一个高效的工具。

核心功能

• 跨平台兼容性：支持 Linux、macOS 和 Windows。
• 灵活的 Apache-2.0 许可证：允许用户自由修改和构建自己的桌面应用程序。
• 动态 LLM 配置：兼容所有 OpenAI SDK 支持的 LLMs，支持手动或预设配置快速测试多个后端。
• 多客户端管理：通过 MCP 配置管理多个客户端，连接多个服务器。
• UI 适应性：UI 可直接提取用于 Web，确保 Web 和桌面版本的一致性和交互逻辑。

适用场景

• 开发者工具：用于快速测试和调试多个 LLMs 后端。
• 教育研究：帮助理解 MCP 核心原理和 LLMs 交互机制。
• AI 辅助开发：作为 AI 辅助开发工具，支持动态配置和功能扩展。

工具列表

• server-everything：用于测试多种功能。
• server-filesystem：用于文件系统操作。
• server-puppeteer：用于浏览器自动化。

常见问题解答

1. Error: spawn npx ENOENT：修改 config.json 文件，确保路径有效。
2. 安装超时：可能是由于 Electron 下载速度慢，建议修改 ELECTRON_MIRROR 环境变量。
3. Electron builder 超时：清除缓存后重试，建议使用默认终端而非 VSCode 内置终端。

使用教程

使用依赖

1. 确保已安装 Node.js。
2. 验证安装： bash node -v npm -v

安装教程

1. 克隆或下载仓库。
2. 修改 src/main/config.json 文件，确保 command 和 path 有效。
3. 安装依赖： bash npm install
4. 启动应用： bash npm start

调试方式

1. 检查 config.json 配置是否正确。
2. 确保路径为绝对路径。
3. 使用 DevTool 进行调试（如示例图中的 DevTool Troubleshooting）。

构建应用

npm run build-app

构建完成后，产物将存储在 /artifacts 目录中。

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。