MCP 聊天应用

What is MCP 聊天应用?

MCP 聊天应用是一个基于 Model Context Protocol (MCP) 的智能聊天应用，支持 Web 和桌面环境（基于 Electron）。它面向需要使用 AI 模型与外部工具和服务进行交互的用户，集成了 OpenAI 和 Anthropic 两种主流大模型服务。

How to use MCP 聊天应用？

安装 Node.js v16+ 和 npm v8+ 后，运行 npm install 安装依赖，可选复制 .env.example 为 .env 并配置 API 密钥和模型提供商。启动应用需分别运行前端开发服务器（npm run dev 或 npm run electron:dev）和 MCP 后端服务（npm run mcp:server）。在应用内通过设置面板配置 API 密钥、模型提供商和模型，然后即可在聊天界面中发送消息，AI 可自动调用 MCP 工具执行任务。

Key features of MCP 聊天应用

• 简洁现代的聊天界面设计
• 支持 MCP 协议与外部工具无缝交互
• 兼容 OpenAI 和 Anthropic 两种 API 格式
• 可配置 API 密钥、基础 URL 和模型选项
• 跨平台桌面应用（Windows/Mac/Linux）
• 集成浏览器自动化、天气查询、新闻搜索等工具

Use cases of MCP 聊天应用

• 通过聊天请求 AI 控制浏览器访问网页、提取信息
• 询问实时天气信息，AI 自动调用天气查询工具
• 检索最新新闻内容，AI 调用新闻搜索工具
• 在桌面版应用中，通过 AI 读取和写入本地文件

FAQ from MCP 聊天应用

如何配置 API 密钥和模型？

在应用内点击右上角 ⚙️ 设置图标，在设置面板中选择模型提供商（OpenAI 或 Anthropic），输入对应 API 密钥，并可自定义 API 基础 URL 和模型；还支持添加和管理自定义模型。

支持哪些模型提供商？

支持 OpenAI 和 Anthropic 两种主流大模型服务，兼容其 API 格式。

如何构建桌面应用？

运行 npm run electron:build 可构建所有平台版本；也可使用 npm run electron:buildwin（Windows）、npm run electron:buildmac（macOS）或 npm run electron:buildlinux（Linux）构建特定平台版本，安装包位于 dist_electron 目录。

MCP 工具调用失败怎么办？

检查 MCP 后端日志，确保相关依赖已安装且工具正确配置；同时确认 MCP 后端服务（npm run mcp:server）正在运行。

这个项目是否开源？采用什么许可证？

项目采用 MIT 许可证，欢迎提交 Pull Request 或 Issue 进行贡献。