[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-9239":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":19,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":24,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":31,"readmeContent":32,"aiSummary":33,"trendingCount":16,"starSnapshotCount":16,"syncStatus":34,"lastSyncTime":35,"discoverSource":36},9239,"chatmcp","daodao97\u002Fchatmcp","daodao97","ChatMCP is an AI chat client implementing the Model Context Protocol (MCP).","https:\u002F\u002Fdaodao97.github.io\u002Fchatmcp\u002F",null,"Dart",2194,208,14,46,0,3,10,1,28.96,"Apache License 2.0",false,"main",true,[26,27,28,29,30],"ai","chat","client","mcp","mcp-client","2026-06-12 02:02:04","\u003Cdiv align=\"center\">\n\u003Cimg src=\".\u002Fassets\u002Flogo.png\" alt=\"logo\" width=\"120\" height=\"120\">\n\u003Ch1>chatmcp\u003C\u002Fh1>\n\nCross-platform `Macos | Windows | Linux | iOS | Android | Web` AI Chat Client\n\n[English](.\u002FREADME.md) | [简体中文](.\u002FREADME_ZH.md) | [Türkçe](.\u002FREADME_TR.md)\n\n\u003C\u002Fdiv>\n\n## Install\n\n| macOS                                                   | Windows                                                 | Linux                                                     | iOS                                                      | Android                                                 | Web                                                    |\n|---------------------------------------------------------|---------------------------------------------------------|-----------------------------------------------------------|----------------------------------------------------------|---------------------------------------------------------|--------------------------------------------------------|\n| [Release](https:\u002F\u002Fgithub.com\u002Fdaodao97\u002Fchatmcp\u002Freleases) | [Release](https:\u002F\u002Fgithub.com\u002Fdaodao97\u002Fchatmcp\u002Freleases) | [Release](https:\u002F\u002Fgithub.com\u002Fdaodao97\u002Fchatmcp\u002Freleases) ¹ | [TestFlight](https:\u002F\u002Ftestflight.apple.com\u002Fjoin\u002FdCXksFJV) | [Release](https:\u002F\u002Fgithub.com\u002Fdaodao97\u002Fchatmcp\u002Freleases) | [GitHub Pages](https:\u002F\u002Fdaodao97.github.io\u002Fchatmcp) ² |\n\n¹ **Linux Notes:** \n- See Linux requirements below for AppImage\u002FDEB runtime dependencies on Ubuntu 22.04 and 24.04\n- Improved Experience: Latest versions include better dark theme support, unified data storage following [XDG Base Directory Specification](https:\u002F\u002Fspecifications.freedesktop.org\u002Fbasedir-spec\u002Fbasedir-spec-latest.html), and optimized UI layout for Linux desktop environments is planned\n- Tested on major distributions: Ubuntu, Fedora, Arch Linux, openSUSE\n\n² Note: Web version runs entirely in your browser with local storage for chat history and settings.\n\n## Documentation\n\nAlso, you can use DeepWiki to get more information about chatmcp.  \n[![Ask DeepWiki](https:\u002F\u002Fdeepwiki.com\u002Fbadge.svg)](https:\u002F\u002Fdeepwiki.com\u002Fdaodao97\u002Fchatmcp) DeepWiki is an AI-powered platform that transforms any\npublic GitHub repository into a fully interactive, easy-to-understand wiki. By analysing code, documentation, and configuration files, it creates\nclear explanations, interactive diagrams, and even allows for real-time Q&A with the AI.\n\n## Preview\n\n![Artifact Display](.\u002Fdocs\u002Fpreview\u002Fartifact.gif)\n![Thinking Mode](.\u002Fdocs\u002Fpreview\u002Fthink.webp)\n![Generate Image](.\u002Fdocs\u002Fpreview\u002Fgen_img.webp)\n![LaTeX Support](.\u002Fdocs\u002Fpreview\u002Flatex.webp)\n![HTML Preview](.\u002Fdocs\u002Fpreview\u002Fhtml-preview.webp)\n![Mermaid Diagram](.\u002Fdocs\u002Fpreview\u002Fmermaid.webp)\n![MCP Workflow](.\u002Fdocs\u002Fpreview\u002Fmcp-workerflow.webp)\n![MCP InMemory](.\u002Fdocs\u002Fpreview\u002Fmcp-inmemory.webp)\n![MCP Tools](.\u002Fdocs\u002Fpreview\u002Fmcp-tools.webp)\n![LLM Provider](.\u002Fdocs\u002Fpreview\u002Fllm-provider.webp)\n![MCP Stdio](.\u002Fdocs\u002Fpreview\u002Fmcp-stdio.webp)\n![MCP SSE](.\u002Fdocs\u002Fpreview\u002Fmcp-sse.webp)\n\n### Data Sync\n\nChatMCP applications can sync data within the same local area network\n\n![Data sync](.\u002Fdocs\u002Fpreview\u002Fdata-sync.webp)\n\n## Usage\n\nMake sure you have installed `uvx` or `npx` in your system\n\n### MacOS\n\n```bash\n# uvx\nbrew install uv\n\n# npx\nbrew install node \n```\n\n### Linux\n\n```bash\n# uvx\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# npx (using apt)\nsudo apt update\nsudo apt install nodejs npm\n```\n\n### Linux Requirements (Ubuntu 22.04 and 24.04)\n\nFor running ChatMCP AppImage\u002FDEB on Ubuntu and derivatives, install the following runtime packages:\n\n- AppImage (FUSE): `libfuse2`\n- GTK 3: `libgtk-3-0`\n- Graphics\u002FEGL:\n  - Ubuntu 22.04: `libegl1-mesa`, `libgles2`, `libgl1-mesa-dri`, `libglx-mesa0`\n  - Ubuntu 24.04: `libegl1`, `libgles2`, `libgl1-mesa-dri`, `libglx-mesa0`\n- X11 utilities and SQLite: `libx11-6`, `xdg-utils`, `libsqlite3-0`\n\nInstall commands:\n\n- Ubuntu 22.04:\n```bash\nsudo apt install -y libfuse2 libgtk-3-0 libegl1-mesa libgles2 libgl1-mesa-dri libglx-mesa0 libx11-6 xdg-utils libsqlite3-0 libsqlite3-dev\n```\n\n- Ubuntu 24.04:\n```bash\nsudo apt install -y libfuse2 libgtk-3-0 libegl1 libgles2 libgl1-mesa-dri libglx-mesa0 libx11-6 xdg-utils libsqlite3-0 libsqlite3-dev\n```\n\nOptional (recommended): `mesa-vulkan-drivers`, `mesa-utils` (for diagnostics like glxinfo)\n\n1. Configure Your LLM API Key and Endpoint in `Setting` Page\n2. Install MCP Server from `MCP Server` Page\n3. Chat with MCP Server\n\n- stdio mcp server\n  ![](.\u002Fdocs\u002Fmcp_stdio.png)\n\n- sse mcp server\n  ![](.\u002Fdocs\u002Fmcp_sse.png)\n\n## Data Storage\n\nChatMCP follows platform-specific best practices for data storage:\n\n### Storage Locations\n\n**macOS:**\n```bash\n~\u002FLibrary\u002FApplication Support\u002FChatMcp\u002F\n```\n\n**Windows:**\n```bash\n%APPDATA%\\ChatMcp\\\n```\n\n**Linux:**\n```bash\n~\u002F.local\u002Fshare\u002FChatMcp\u002F           # Honors $XDG_DATA_HOME if set\n~\u002F.local\u002Fshare\u002Frun.daodao.chatmcp # Flutter dependency\n```\n\n**Mobile:**\n- Application Documents Directory\n\n### File Structure\n\nAll platforms store data in a unified directory structure:\n- `logs` folder - Application logs\n- `chatmcp.db` - Main database file containing chat history and messages\n- `shared_preferences.json` - Application settings and preferences\n- `mcp_server.json` - MCP server configurations\n\n### Reset Application Data\n\nTo completely reset the application (delete all chat history, settings, and configurations):\n\n**macOS:**\n```bash\nrm -rf ~\u002FLibrary\u002FApplication\\ Support\u002FChatMcp\n```\n\n**Windows:**\n```bash\nrd \u002Fs \u002Fq \"%APPDATA%\\ChatMcp\"\n```\n\n**Linux:**\n```bash\nrm -rf ~\u002F.local\u002Fshare\u002FChatMcp\nrm -rf ~\u002F.local\u002Fshare\u002Frun.daodao.chatmcp\n```\n\n## Development\n\n### Install Flutter\n\nTo develop or run ChatMCP, you need to have [Flutter](https:\u002F\u002Fflutter.dev\u002F) installed.  \nFollow the official [Flutter installation guide](https:\u002F\u002Fdocs.flutter.dev\u002Fget-started\u002Finstall) for your platform.\n\n- [Download Flutter](https:\u002F\u002Fdocs.flutter.dev\u002Fget-started\u002Finstall)\n\nAfter installing, verify with:\n```bash\nflutter --version\n```\n\n### Mandatory Code Formatting and Pre-commit Hook\n\nTo keep a consistent code style across contributors, this repository enforces Dart formatting on every commit.\n\n- The repository ships a versioned Git hook at `.githooks\u002Fpre-commit`.\n- On commit, it runs `dart format .`, re-adds changed files, and then performs a no-output check to ensure nothing remains unformatted.\n- Commits that are not properly formatted will be rejected locally; in addition, CI will fail unformatted PRs.\n\nQuick setup (once per clone):\n\n```bash\nmake setup-git-hooks\n```\n\nManual setup (alternative):\n\n```bash\ngit config core.hooksPath .githooks\nchmod +x .githooks\u002Fpre-commit\n```\n\nRequirements (at least one must be available on PATH):\n\n- Dart SDK, or\n- Flutter (bundles Dart)\n\nExamples:\n\n- macOS\u002FLinux (Flutter):\n  ```bash\n  export PATH=\"$PATH:$HOME\u002Fflutter\u002Fbin\"\n  which flutter && flutter --version\n  which dart && dart --version\n  ```\n- macOS\u002FLinux (Dart SDK):\n  ```bash\n  export PATH=\"$PATH:$HOME\u002Fdart-sdk\u002Fbin\"\n  which dart && dart --version\n  ```\n- Windows (PowerShell): Add `C:\\\\src\\\\flutter\\\\bin` (or your Flutter path) to the User\u002FSystem PATH. Validate via:\n  ```powershell\n  where flutter\n  where dart\n  ```\n\nIDE note: After changing PATH, restart your IDE so VCS operations (commit) inherit the updated environment.\n\nCI enforcement:\n\n- A GitHub Actions workflow `check-format` runs `dart format --output=none --set-exit-if-changed .` on push\u002FPR and will fail if any file is not formatted.\n\nPolicy:\n\n- Do not bypass hooks (e.g., `--no-verify`). Such changes will fail in CI and must be reformatted anyway.\n\n### Clone and Run Locally\n\n```bash\n# Clone the repository\ngit clone https:\u002F\u002Fgithub.com\u002Fdaodao97\u002Fchatmcp.git\ncd chatmcp\n\n# Install dependencies\nflutter pub get\n\n# Run on macOS\nflutter run -d macos\n\n# Run on Linux (requires Flutter desktop support enabled)\nflutter run -d linux\n\n# Build release for Linux\nflutter build linux\n```\n\n### Web Version\n\n#### Local Development\n```bash\n# Install dependencies\nflutter pub get\n\n# Run Web version locally\nflutter run -d chrome\n# Or specify port\nflutter run -d chrome --web-port 8080\n# Or run as web-serer for other browsers.\nflutter run -d web-server\n```\n\n#### Build Web Version\n```bash\n# Build production version\nflutter build web\n\n# Build with base path (for deploying to subdirectory)\nflutter build web --base-href \u002Fchatmcp\u002F\n```\n\n#### Deploy to GitHub Pages\n```bash\n# 1. Build Web version\nflutter build web --base-href \u002Fchatmcp\u002F\n\n# 2. Push build\u002Fweb directory contents to gh-pages branch\n# Or use GitHub Actions for automatic deployment\n```\n\nAfter building, files will be in the `build\u002Fweb` directory and can be deployed to any static website hosting service.\n\n## Features\n\n- [x] Chat with MCP Server\n- [X] MCP Server Market\n- [ ] Auto install MCP Server\n- [x] SSE MCP Transport Support\n- [x] Auto Choose MCP Server\n- [x] Chat History\n- [x] OpenAI LLM Model\n- [x] Claude LLM Model\n- [x] OLLama LLM Model\n- [x] DeepSeek LLM Model\n- [ ] RAG\n- [ ] Better UI Design\n- [x] Dark\u002FLight Theme\n\nAll features are welcome to submit, you can submit your ideas or bugs in [Issues](https:\u002F\u002Fgithub.com\u002Fdaodao97\u002Fchatmcp\u002Fissues)\n\n## MCP Server Market\n\nYou 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.\n\n* Also you can add new MCP Server to the Market : [MCP Server Market](https:\u002F\u002Fgithub.com\u002Fchatmcpclient\u002Fmcp_server_market\u002Fblob\u002Fmain\u002Fmcp_server_market.json)\n\nCreate a fork of [mcp_server_market](https:\u002F\u002Fgithub.com\u002Fchatmcpclient\u002Fmcp_server_market) and add your MCP Server to the `mcp_server_market.json` end of the file.\n\n```json\n{\n    \"mcpServers\": {\n        \"existing-mcp-servers\": {},\n        \"your-mcp-server\": {\n              \"command\": \"uvx\",\n              \"args\": [\n                  \"--from\",\n                  \"git+https:\u002F\u002Fgithub.com\u002Fusername\u002Fyour-mcp-server\",\n                  \"your-mcp-server\"\n            ]\n        }\n    }\n}\n```\nYou can send a Pull Request to the [mcp_server_market](https:\u002F\u002Fgithub.com\u002Fchatmcpclient\u002Fmcp_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.\n\nYour feedback helps us improve chatmcp and helps other users make informed decisions.\n\n## Thanks\n\n- [MCP](https:\u002F\u002Fmodelcontextprotocol.io\u002Fintroduction)\n- [mcp-cli](https:\u002F\u002Fgithub.com\u002Fchrishayuk\u002Fmcp-cli)\n\n## License\n\nThis project is licensed under the [Apache License 2.0](.\u002FLICENSE).\n\n## Star History\n\n![](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=daodao97\u002Fchatmcp&type=Date)\n","ChatMCP 是一个实现模型上下文协议（MCP）的跨平台AI聊天客户端。它支持MacOS、Windows、Linux、iOS、Android和Web平台，采用Dart语言开发。核心功能包括多平台数据同步、生成图像、LaTeX支持、HTML预览以及Mermaid图表等，提供丰富的交互体验。技术特点方面，ChatMCP遵循XDG Base Directory Specification以优化Linux用户的使用体验，并且其Web版本能够在浏览器中完全运行，利用本地存储保存聊天记录与设置。此项目适用于需要在不同设备上进行高效沟通并享受多样化内容展示能力的个人或团队。",2,"2026-06-11 03:21:50","top_language"]