ChatMCP：开源跨平台 MCP 客户端，让 AI 对话更强大

本文介绍 ChatMCP，一款基于 Flutter 开发的开源跨平台 AI 聊天客户端。它实现了 Model Context Protocol (MCP) 协议，支持连接各种 MCP 服务器扩展 AI 能力，目前已获得 2.2k+ stars。

项目简介

ChatMCP 是由 daodao97 开发维护的开源项目，采用 Flutter 框架构建，实现了真正的跨平台支持。该项目在 GitHub 上已获得超过 2.2k stars，是一个功能丰富且活跃的 MCP 客户端实现。

核心价值：

• 统一接口连接多种 LLM 模型（OpenAI、Claude、OLLama、DeepSeek）
• 通过 MCP 协议扩展无限功能（文件系统、数据库、API 等）
• 全平台数据同步，支持局域网内设备间同步
• 完全开源，可自由定制和扩展

核心特性

• 多平台支持：macOS、Windows、Linux、iOS、Android、Web
• 多模型兼容：OpenAI、Claude、OLLama、DeepSeek LLM 模型
• MCP 协议支持：stdio 和 SSE 两种传输方式
• 智能功能：Artifact 显示、思考模式、图片生成、LaTeX 支持
• 数据同步：同一局域网内多设备数据同步
• 主题切换：深色/浅色主题适配
• 丰富预览：HTML 预览、Mermaid 图表渲染

技术栈

• Flutter - 跨平台 UI 框架
• Dart - 编程语言
• MCP Protocol - Model Context Protocol 实现
• SQLite - 本地数据存储
• OAuth 2.0 + PKCE - 安全的 MCP 服务器认证

安装指南

macOS / Windows / Linux

从 GitHub Releases 下载对应平台的安装包。

Linux 运行环境需求（Ubuntu）：

# Ubuntu 22.04
sudo apt install -y libfuse2 libgtk-3-0 libegl1-mesa libgles2 libgl1-mesa-dri libglx-mesa0 libx11-6 xdg-utils libsqlite3-0

# Ubuntu 24.04
sudo apt install -y libfuse2 libgtk-3-0 libegl1 libgles2 libgl1-mesa-dri libglx-mesa0 libx11-6 xdg-utils libsqlite3-0

iOS

通过 TestFlight 安装测试版。

Android

从 GitHub Releases 下载 APK 安装。

Web 版本

直接访问 GitHub Pages，完全在浏览器中运行。

前置依赖

使用 MCP 服务器需要安装以下工具之一：

# 安装 uvx（推荐）
brew install uv

# 或安装 npx
brew install node

快速开始

1. 配置 LLM：在"设置"页面配置 API 密钥和端点
2. 安装 MCP 服务器：从"MCP 服务器"页面浏览并安装
3. 开始对话：与 MCP 服务器进行智能对话

使用示例

连接 stdio MCP 服务器

# 例如使用文件系统 MCP 服务器
uvx @modelcontextprotocol/server-filesystem /path/to/directory

连接 SSE MCP 服务器

在设置中配置 SSE 端点 URL，例如：

数据同步

在同一局域网内，多台设备可自动同步聊天记录和配置。

MCP 服务器市场

ChatMCP 内置 MCP 服务器市场，可以方便地安装各种功能扩展：

• 文件系统操作
• 数据库查询
• Git 操作
• 网络请求
• 代码执行

也可以向 mcp_server_market 提交自己的 MCP 服务器。

开发构建

# 克隆仓库
git clone https://github.com/daodao97/chatmcp.git
cd chatmcp

# 安装依赖
flutter pub get

# 运行开发版本
flutter run -d macos

# 构建 Web 版本
flutter build web --base-href /chatmcp/

# 构建 Android
flutter build apk --release

数据存储位置

• macOS: ~/Library/Application Support/ChatMcp
• Windows: %APPDATA%\ChatMcp
• Linux: ~/.local/share/ChatMcp
• 移动端: 应用文档目录

项目链接

• GitHub 仓库: https://github.com/daodao97/chatmcp
• Web 演示: https://daodao97.github.io/chatmcp
• MCP 市场: https://github.com/chatmcpclient/mcp_server_market
• 问题反馈: https://github.com/daodao97/chatmcp/issues

许可证

Apache License 2.0