chatmcp

<div align="center"> <img src="./assets/logo.png" alt="logo" width="120" height="120"> <h1>chatmcp</h1> Cross-platform `Macos | Windows | Linux | iOS | Android | Web` AI Chat Client [English](./README.md) | [简体中文](./README_ZH.md) | [Türkçe](./README_TR.md) </div> ## Install | macOS | Windows | Linux | iOS | Android | Web | |---------------------------------------------------------|---------------------------------------------------------|-----------------------------------------------------------|----------------------------------------------------------|---------------------------------------------------------|--------------------------------------------------------| | [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) ² | ¹ **Linux Notes:** - See Linux requirements below for AppImage/DEB runtime dependencies on Ubuntu 22.04 and 24.04 - 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 - Tested on major distributions: Ubuntu, Fedora, Arch Linux, openSUSE ² Note: Web version runs entirely in your browser with local storage for chat history and settings. ## Documentation Also, you can use DeepWiki to get more information about chatmcp. [](https://deepwiki.com/daodao97/chatmcp) DeepWiki is an AI-powered platform that transforms any public GitHub repository into a fully interactive, easy-to-understand wiki. By analysing code, documentation, and configuration files, it creates clear explanations, interactive diagrams, and even allows for real-time Q&A with the AI. ## Preview             ### Data Sync ChatMCP applications can sync data within the same local area network  ## Usage Make sure you have installed `uvx` or `npx` in your system ### MacOS ```bash # uvx brew install uv # npx brew install node ``` ### Linux ```bash # uvx curl -LsSf https://astral.sh/uv/install.sh | sh # npx (using apt) sudo apt update sudo apt install nodejs npm ``` ### Linux Requirements (Ubuntu 22.04 and 24.04) For running ChatMCP AppImage/DEB on Ubuntu and derivatives, install the following runtime packages: - AppImage (FUSE): `libfuse2` - GTK 3: `libgtk-3-0` - Graphics/EGL: - Ubuntu 22.04: `libegl1-mesa`, `libgles2`, `libgl1-mesa-dri`, `libglx-mesa0` - Ubuntu 24.04: `libegl1`, `libgles2`, `libgl1-mesa-dri`, `libglx-mesa0` - X11 utilities and SQLite: `libx11-6`, `xdg-utils`, `libsqlite3-0` Install commands: - Ubuntu 22.04: ```bash sudo apt install -y libfuse2 libgtk-3-0 libegl1-mesa libgles2 libgl1-mesa-dri libglx-mesa0 libx11-6 xdg-utils libsqlite3-0 libsqlite3-dev ``` - Ubuntu 24.04: ```bash sudo apt install -y libfuse2 libgtk-3-0 libegl1 libgles2 libgl1-mesa-dri libglx-mesa0 libx11-6 xdg-utils libsqlite3-0 libsqlite3-dev ``` Optional (recommended): `mesa-vulkan-drivers`, `mesa-utils` (for diagnostics like glxinfo) 1. Configure Your LLM API Key and Endpoint in `Setting` Page 2. Install MCP Server from `MCP Server` Page 3. Chat with MCP Server - stdio mcp server  - sse mcp server  ## Data Storage ChatMCP follows platform-specific best practices for data storage: ### Storage Locations **macOS:** ```bash ~/Library/Application Support/ChatMcp/ ``` **Windows:** ```bash %APPDATA%\ChatMcp\ ``` **Linux:** ```bash ~/.local/share/ChatMcp/ # Honors $XDG_DATA_HOME if set ~/.local/share/run.daodao.chatmcp # Flutter dependency ``` **Mobile:** - Application Documents Directory ### File Structure All platforms store data in a unified directory structure: - `logs` folder - Application logs - `chatmcp.d