daodao97/chatmcp

Cross-platform Macos | Windows | Linux | iOS | Android | Web AI Chat Client
English | 简体中文 | Türkçe
## Install
| macOS | Windows | Linux | iOS | Android | Web |
| Release | Release | Release ¹ | TestFlight | Release | GitHub Pages ² |
¹ 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, 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.
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 $XDGDATAHOME 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.db - Main database file containing chat history and messages
sharedpreferences.json - Application settings and preferences
mcpserver.json - MCP server configurations
### Reset Application Data
To completely reset the application (delete all chat history, settings, and configurations):
macOS:
bash
rm -rf ~/Library/Application\ Support/ChatMcp