安装
| macOS | Windows | Linux | iOS | Android | Web |
|---|---|---|---|---|---|
| Release | Release | Release ¹ | TestFlight | Release | GitHub Pages ² |
¹ Linux 注意事项：
- 安装必要的依赖项：
sudo apt install libsqlite3-0 libsqlite3-dev在 Debian/Ubuntu 及其衍生版本上 - 优化体验：最新版本包含更好的暗黑主题支持、遵循 XDG Base Directory Specification 的统一数据存储，并计划为 Linux 桌面环境优化 UI 布局
- 测试过的主要发行版：Ubuntu、Fedora、Arch Linux、openSUSE
² 注意：Web 版本完全在您的浏览器中运行，使用本地存储保存聊天历史和设置。
文档
此外，您还可以使用 DeepWiki 获取更多关于 chatmcp 的信息。
DeepWiki 是一个 AI 驱动的平台，可以将任何公开的 GitHub 仓库转换为完全交互式、易于理解的维基。通过分析代码、文档和配置文件，它会创建清晰的解释、交互式图表，甚至允许与 AI 进行实时问答。
预览
数据同步
ChatMCP 应用可以在同一局域网内同步数据
使用
确保您的系统已安装 uvx 或 npx
MacOS
# uvx
brew install uv
# npx
brew install node
Linux
# uvx
curl -LsSf https://astral.sh/uv/install.sh | sh
# npx (使用 apt)
sudo apt update
sudo apt install nodejs npm
- 在
设置页面配置您的 LLM API 密钥和端点 - 从
MCP Server页面安装 MCP Server - 与 MCP Server 进行聊天
-
stdio mcp server
-
sse mcp server
数据存储
ChatMCP 遵循平台特定的最佳实践进行数据存储：
存储位置
macOS:
~/Library/Application Support/ChatMcp/
Windows:
%APPDATA%\ChatMcp\
Linux:
~/.local/share/ChatMcp/ # 如果设置了 $XDG_DATA_HOME 则会遵循
~/.local/share/run.daodao.chatmcp # Flutter 依赖
移动端:
- 应用文档目录
文件结构
所有平台都使用统一的目录结构存储数据：
logs文件夹 - 应用日志chatmcp.db- 包含聊天历史和消息的主数据库文件shared_preferences.json- 应用设置和偏好mcp_server.json- MCP Server 配置
重置应用数据
要完全重置应用（删除所有聊天历史、设置和配置）：
macOS:
rm -rf ~/Library/Application\ Support/ChatMcp
Windows:
rd /s /q "%APPDATA%\ChatMcp"
Linux:
rm -rf ~/.local/share/ChatMcp
rm -rf ~/.local/share/run.daodao.chatmcp
开发
安装 Flutter
要开发或运行 ChatMCP，您需要安装 Flutter。
请遵循您平台的官方 Flutter 安装指南。
安装后，验证：
flutter --version
本地克隆和运行
# 克隆仓库
git clone https://github.com/daodao97/chatmcp.git
cd chatmcp
# 安装依赖
flutter pub get
# 在 macOS 上运行
flutter run -d macos
# 在 Linux 上运行（需要启用 Flutter 桌面支持）
flutter run -d linux
# 构建 Linux 发布版本
flutter build linux
Web 版本
本地开发
# 安装依赖
flutter pub get
# 本地运行 Web 版本
flutter run -d chrome
# 或指定端口
flutter run -d chrome --web-port 8080
# 或以 web-server 模式运行供其他浏览器使用
flutter run -d web-server
构建 Web 版本
# 构建 production 版本
flutter build web
# 使用 base path 构建（用于部署到子目录）
flutter build web --base-href /chatmcp/
部署到 GitHub Pages
# 1. 构建 Web 版本
flutter build web --base-href /chatmcp/
# 2. 将 build/web 目录内容推送到 gh-pages 分支
# 或使用 GitHub Actions 自动部署
构建后，文件将位于 build/web 目录，可以部署到任何静态网站托管服务。
功能
- 与 MCP Server 聊天
- MCP Server 市场
- 自动安装 MCP Server
- SSE MCP 传输支持
- 自动选择 MCP Server
- 聊天历史
- OpenAI LLM 模型
- Claude LLM 模型
- OLLama LLM 模型
- DeepSeek LLM 模型
- RAG
- 更好的 UI 设计
- 暗黑/明亮主题
所有功能都欢迎提交，您可以提交您的想法或 Bug 到 Issues
MCP Server 市场
您可以从 MCP Server 市场 安装 MCP Server，MCP Server 市场 是一个 MCP Server 集合，您可以使用它来与不同的数据聊天。
- 您也可以将新的 MCP Server 添加到市场：MCP Server Market
创建 mcp_server_market 的分支，并将您的 MCP Server 添加到 mcp_server_market.json 文件的末尾。
{
"mcpServers": {
"existing-mcp-servers": {},
"your-mcp-server": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/username/your-mcp-server",
"your-mcp-server"
]
}
}
}
您可以向 mcp_server_market 仓库提交 Pull Request 以将您的 MCP Server 添加到市场。您的 PR 合并后，您的 MCP Server 将会出现在市场中，其他用户可以立即使用它。
您的反馈有助于我们改进 chatmcp，并帮助其他用户做出明智的决策。
致谢
许可证
本项目根据 Apache License 2.0 授权。
Star 历史
