Skip to content
Back to search

chatmcp

ChatMCP is an AI chat client implementing the Model Context Protocol (MCP).

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/daodao97/chatmcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/daodao97/chatmcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/daodao97--chatmcp/badge.svg)](/listings/daodao97--chatmcp)

HTML

<a href="/listings/daodao97--chatmcp"><img src="/api/listings/daodao97--chatmcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

To develop or run ChatMCP, you need to have [Flutter](https://flutter.dev/) installed. Follow the official [Flutter installation guide](https://docs.flutter.dev/get-started/install) for your platform.

- [Download Flutter](https://docs.flutter.dev/get-started/install)

After installing, verify with:

flutter --version

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 345 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="./assets/logo.png" alt="logo" width="120" height="120">
  3. <h1>chatmcp</h1>
  4. Cross-platform `Macos | Windows | Linux | iOS | Android | Web` AI Chat Client
  5. [English](./README.md) | [简体中文](./README_ZH.md) | [Türkçe](./README_TR.md)
  6. </div>
  7. ## Install
  8. | macOS | Windows | Linux | iOS | Android | Web |
  9. |---------------------------------------------------------|---------------------------------------------------------|-----------------------------------------------------------|----------------------------------------------------------|---------------------------------------------------------|--------------------------------------------------------|
  10. | [Release](https://github.com/daodao97/chatmcp/releases) | [Release](https://github.com/daodao97/chatmcp/releases) | [Release](https://github.com/daodao97/chatmcp/releases) ¹ | [TestFlight](https://testflight.apple.com/join/dCXksFJV) | [Release](https://github.com/daodao97/chatmcp/releases) | [GitHub Pages](https://daodao97.github.io/chatmcp) ² |
  11. ¹ **Linux Notes:**
  12. - See Linux requirements below for AppImage/DEB runtime dependencies on Ubuntu 22.04 and 24.04
  13. - Improved Experience: Latest versions include better dark theme support, unified data storage following [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html), and optimized UI layout for Linux desktop environments is planned
  14. - Tested on major distributions: Ubuntu, Fedora, Arch Linux, openSUSE
  15. ² Note: Web version runs entirely in your browser with local storage for chat history and settings.
  16. ## Documentation
  17. Also, you can use DeepWiki to get more information about chatmcp.
  18. [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/daodao97/chatmcp) DeepWiki is an AI-powered platform that transforms any
  19. public GitHub repository into a fully interactive, easy-to-understand wiki. By analysing code, documentation, and configuration files, it creates
  20. clear explanations, interactive diagrams, and even allows for real-time Q&A with the AI.
  21. ## Preview
  22. ![Artifact Display](./docs/preview/artifact.gif)
  23. ![Thinking Mode](./docs/preview/think.webp)
  24. ![Generate Image](./docs/preview/gen_img.webp)
  25. ![LaTeX Support](./docs/preview/latex.webp)
  26. ![HTML Preview](./docs/preview/html-preview.webp)
  27. ![Mermaid Diagram](./docs/preview/mermaid.webp)
  28. ![MCP Workflow](./docs/preview/mcp-workerflow.webp)
  29. ![MCP InMemory](./docs/preview/mcp-inmemory.webp)
  30. ![MCP Tools](./docs/preview/mcp-tools.webp)
  31. ![LLM Provider](./docs/preview/llm-provider.webp)
  32. ![MCP Stdio](./docs/preview/mcp-stdio.webp)
  33. ![MCP SSE](./docs/preview/mcp-sse.webp)
  34. ### Data Sync
  35. ChatMCP applications can sync data within the same local area network
  36. ![Data sync](./docs/preview/data-sync.webp)
  37. ## Usage
  38. Make sure you have installed `uvx` or `npx` in your system
  39. ### MacOS
  40. ```bash
  41. # uvx
  42. brew install uv
  43. # npx
  44. brew install node
  45. ```
  46. ### Linux
  47. ```bash
  48. # uvx
  49. curl -LsSf https://astral.sh/uv/install.sh | sh
  50. # npx (using apt)
  51. sudo apt update
  52. sudo apt install nodejs npm
  53. ```
  54. ### Linux Requirements (Ubuntu 22.04 and 24.04)
  55. For running ChatMCP AppImage/DEB on Ubuntu and derivatives, install the following runtime packages:
  56. - AppImage (FUSE): `libfuse2`
  57. - GTK 3: `libgtk-3-0`
  58. - Graphics/EGL:
  59. - Ubuntu 22.04: `libegl1-mesa`, `libgles2`, `libgl1-mesa-dri`, `libglx-mesa0`
  60. - Ubuntu 24.04: `libegl1`, `libgles2`, `libgl1-mesa-dri`, `libglx-mesa0`
  61. - X11 utilities and SQLite: `libx11-6`, `xdg-utils`, `libsqlite3-0`
  62. Install commands:
  63. - Ubuntu 22.04:
  64. ```bash
  65. sudo apt install -y libfuse2 libgtk-3-0 libegl1-mesa libgles2 libgl1-mesa-dri libglx-mesa0 libx11-6 xdg-utils libsqlite3-0 libsqlite3-dev
  66. ```
  67. - Ubuntu 24.04:
  68. ```bash
  69. sudo apt install -y libfuse2 libgtk-3-0 libegl1 libgles2 libgl1-mesa-dri libglx-mesa0 libx11-6 xdg-utils libsqlite3-0 libsqlite3-dev
  70. ```
  71. Optional (recommended): `mesa-vulkan-drivers`, `mesa-utils` (for diagnostics like glxinfo)
  72. 1. Configure Your LLM API Key and Endpoint in `Setting` Page
  73. 2. Install MCP Server from `MCP Server` Page
  74. 3. Chat with MCP Server
  75. - stdio mcp server
  76. ![](./docs/mcp_stdio.png)
  77. - sse mcp server
  78. ![](./docs/mcp_sse.png)
  79. ## Data Storage
  80. ChatMCP follows platform-specific best practices for data storage:
  81. ### Storage Locations
  82. **macOS:**
  83. ```bash
  84. ~/Library/Application Support/ChatMcp/
  85. ```
  86. **Windows:**
  87. ```bash
  88. %APPDATA%\ChatMcp\
  89. ```
  90. **Linux:**
  91. ```bash
  92. ~/.local/share/ChatMcp/ # Honors $XDG_DATA_HOME if set
  93. ~/.local/share/run.daodao.chatmcp # Flutter dependency
  94. ```
  95. **Mobile:**
  96. - Application Documents Directory
  97. ### File Structure
  98. All platforms store data in a unified directory structure:
  99. - `logs` folder - Application logs
  100. - `chatmcp.db` - Main database file containing chat history and messages
  101. - `shared_preferences.json` - Application settings and preferences
  102. - `mcp_server.json` - MCP server configurations
  103. ### Reset Application Data
  104. To completely reset the application (delete all chat history, settings, and configurations):
  105. **macOS:**
  106. ```bash
  107. rm -rf ~/Library/Application\ Support/ChatMcp
  108. ```
  109. **Windows:**
  110. ```bash
  111. rd /s /q "%APPDATA%\ChatMcp"
  112. ```
  113. **Linux:**
  114. ```bash
  115. rm -rf ~/.local/share/ChatMcp
  116. rm -rf ~/.local/share/run.daodao.chatmcp
  117. ```
  118. ## Development
  119. ### Install Flutter
  120. To develop or run ChatMCP, you need to have [Flutter](https://flutter.dev/) installed.
  121. Follow the official [Flutter installation guide](https://docs.flutter.dev/get-started/install) for your platform.
  122. - [Download Flutter](https://docs.flutter.dev/get-started/install)
  123. After installing, verify with:
  124. ```bash
  125. flutter --version
  126. ```
  127. ### Mandatory Code Formatting and Pre-commit Hook
  128. To keep a consistent code style across contributors, this repository enforces Dart formatting on every commit.
  129. - The repository ships a versioned Git hook at `.githooks/pre-commit`.
  130. - On commit, it runs `dart format .`, re-adds changed files, and then performs a no-output check to ensure nothing remains unformatted.
  131. - Commits that are not properly formatted will be rejected locally; in addition, CI will fail unformatted PRs.
  132. Quick setup (once per clone):
  133. ```bash
  134. make setup-git-hooks
  135. ```
  136. Manual setup (alternative):
  137. ```bash
  138. git config core.hooksPath .githooks
  139. chmod +x .githooks/pre-commit
  140. ```
  141. Requirements (at least one must be available on PATH):
  142. - Dart SDK, or
  143. - Flutter (bundles Dart)
  144. Examples:
  145. - macOS/Linux (Flutter):
  146. ```bash
  147. export PATH="$PATH:$HOME/flutter/bin"
  148. which flutter && flutter --version
  149. which dart && dart --version
  150. ```
  151. - macOS/Linux (Dart SDK):
  152. ```bash
  153. export PATH="$PATH:$HOME/dart-sdk/bin"
  154. which dart && dart --version
  155. ```
  156. - Windows (PowerShell): Add `C:\\src\\flutter\\bin` (or your Flutter path) to the User/System PATH. Validate via:
  157. ```powershell
  158. where flutter
  159. where dart
  160. ```
  161. IDE note: After changing PATH, restart your IDE so VCS operations (commit) inherit the updated environment.
  162. CI enforcement:
  163. - A GitHub Actions workflow `check-format` runs `dart format --output=none --set-exit-if-changed .` on push/PR and will fail if any file is not formatted.
  164. Policy:
  165. - Do not bypass hooks (e.g., `--no-verify`). Such changes will fail in CI and must be reformatted anyway.
  166. ### Clone and Run Locally
  167. ```bash
  168. # Clone the repository
  169. git clone https://github.com/daodao97/chatmcp.git
  170. cd chatmcp
  171. # Install dependencies
  172. flutter pub get
  173. # Run on macOS
  174. flutter run -d macos
  175. # Run on Linux (requires Flutter desktop support enabled)
  176. flutter run -d linux
  177. # Build release for Linux
  178. flutter build linux
  179. ```
  180. ### Web Version
  181. #### Local Development
  182. ```bash
  183. # Install dependencies
  184. flutter pub get
  185. # Run Web version locally
  186. flutter run -d chrome
  187. # Or specify port
  188. flutter run -d chrome --web-port 8080
  189. # Or run as web-serer for other browsers.
  190. flutter run -d web-server
  191. ```
  192. #### Build Web Version
  193. ```bash
  194. # Build production version
  195. flutter build web
  196. # Build with base path (for deploying to subdirectory)
  197. flutter build web --base-href /chatmcp/
  198. ```
  199. #### Deploy to GitHub Pages
  200. ```bash
  201. # 1. Build Web version
  202. flutter build web --base-href /chatmcp/
  203. # 2. Push build/web directory contents to gh-pages branch
  204. # Or use GitHub Actions for automatic deployment
  205. ```
  206. After building, files will be in the `build/web` directory and can be deployed to any static website hosting service.
  207. ## Features
  208. - [x] Chat with MCP Server
  209. - [X] MCP Server Market
  210. - [ ] Auto install MCP Server
  211. - [x] SSE MCP Transport Support
  212. - [x] Auto Choose MCP Server
  213. - [x] Chat History
  214. - [x] OpenAI LLM Model
  215. - [x] Claude LLM Model
  216. - [x] OLLama LLM Model
  217. - [x] DeepSeek LLM Model
  218. - [ ] RAG
  219. - [ ] Better UI Design
  220. - [x] Dark/Light Theme
  221. All features are welcome to submit, you can submit your ideas or bugs in [Issues](https://github.com/daodao97/chatmcp/issues)
  222. ## MCP Server Market
  223. You can install MCP Server from MCP Server Market, MCP Server Market is a collection of MCP Server, you can use it to chat with different data.
  224. * Also you can add new MCP Server to the Market : [MCP Server Market](https://github.com/chatmcpclient/mcp_server_market/blob/main/mcp_server_market.json)
  225. Create a fork of [mcp_server_market](https://github.com/chatmcpclient/mcp_server_market) and add your MCP Server to the `mcp_server_market.json` end of the file.
  226. ```json
  227. {
  228. "mcpServers": {
  229. "existing-mcp-servers": {},
  230. "your-mcp-server": {
  231. "command": "uvx",
  232. "args": [
  233. "--from",
  234. "git+https://github.com/username/your-mcp-server",
  235. "your-mcp-server"
  236. ]
  237. }
  238. }
  239. }
  240. ```
  241. You can send a Pull Request to the [mcp_server_market](https://github.com/chatmcpclient/mcp_server_market) repository to add your MCP Server to the Market. After your PR is merged, your MCP Server will be available in the Market and other users can use it immediately.
  242. Your feedback helps us improve chatmcp and helps other users make informed decisions.
  243. ## Thanks
  244. - [MCP](https://modelcontextprotocol.io/introduction)
  245. - [mcp-cli](https://github.com/chrishayuk/mcp-cli)
  246. ## License
  247. This project is licensed under the [Apache License 2.0](./LICENSE).
  248. ## Star History
  249. ![](https://api.star-history.com/svg?repos=daodao97/chatmcp&type=Date)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.