macOS | Windows | Linux | iOS | Android | Web |
---|---|---|---|---|---|
Release | Release | Release ¹ | TestFlight | Release | GitHub Pages ² |
¹ Linux Notes:
- Install required dependencies:
sudo apt-get install libsqlite3-0 libsqlite3-dev
- Improved Linux Experience: Version 1.x+ includes optimized UI layout for Linux desktop environments, better dark theme support, and unified data storage following XDG specifications
- 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.
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.
ChatMCP applications can sync data within the same local area network
Make sure you have installed uvx
or npx
in your system
# uvx
brew install uv
# npx
brew install node
# uvx
curl -LsSf https://astral.sh/uv/install.sh | sh
# npx (using apt)
sudo apt update
sudo apt install nodejs npm
- Configure Your LLM API Key and Endpoint in
Setting
Page - Install MCP Server from
MCP Server
Page - Chat with MCP Server
ChatMCP follows platform-specific best practices for data storage:
macOS:
~/Library/Application Support/ChatMcp/
Windows:
%APPDATA%\ChatMcp\
Linux: (Follows XDG Base Directory Specification)
~/.local/share/ChatMcp/
Mobile:
- Application Documents Directory
All platforms store data in a unified directory structure:
chatmcp.db
- Main database file containing chat history and messagesconfig.json
- Application settings and preferences- Other MCP server configurations and logs
To completely reset the application (delete all chat history, settings, and configurations):
macOS:
rm -rf ~/Library/Application\ Support/ChatMcp
Windows:
rd /s /q "%APPDATA%\ChatMcp"
Linux:
rm -rf ~/.local/share/ChatMcp
ChatMCP automatically migrates your existing data when you upgrade to a newer version with unified storage locations.
The application will automatically transfer:
- ✅ Chat Database (
chatmcp.db
) - All your chat history and messages - ✅ Application Settings - Your preferences and configurations
- ✅ MCP Server Configurations (
mcp_server.json
) - Your custom MCP server setups - ✅ Log Files - Application logs from the
logs/
directory - ✅ Other Configuration Files - Any other settings files
Linux: From scattered directories to unified XDG-compliant location:
# FROM (old locations):
~/.local/share/run.daodao.chatmcp/ # Old config directory
~/.local/share/ChatMcp/ # Old data directory
# TO (new unified location):
~/.local/share/ChatMcp/
Windows & macOS: Migrates from any previously used application data directories to the current standardized locations.
- Automatic Detection: On first launch after upgrade, ChatMCP scans for existing data
- Safe Copy: Data is copied (not moved) to the new location to prevent data loss
- Verification: The application confirms successful migration before using new data
- User Notification: You'll see confirmation messages about migrated files
After confirming your application works correctly with migrated data, you can manually clean up old directories:
Linux:
# Clean up old directories (only after confirming migration worked):
rm -rf ~/.local/share/run.daodao.chatmcp # Old config directory
# Note: Check if old ChatMcp directory differs from new location before removing
Windows & macOS: Old directories will be clearly identified in the migration messages for manual cleanup.
If you encounter migration issues:
- Check Migration Status: Use the debug information in the application
- Manual Migration: You can manually copy files if automatic migration fails
- Reset and Reconfigure: As a last resort, you can reset application data and reconfigure
For advanced users, you can check migration status by running:
# Create and run a migration test script
dart test_migration.dart
flutter pub get
flutter run -d macos
# Install dependencies
flutter pub get
# Run Web version locally
flutter run -d chrome
# Or specify port
flutter run -d chrome --web-port 8080
# Build production version
flutter build web
# Build with base path (for deploying to subdirectory)
flutter build web --base-href /chatmcp/
# 1. Build Web version
flutter build web --base-href /chatmcp/
# 2. Push build/web directory contents to gh-pages branch
# Or use GitHub Actions for automatic deployment
After building, files will be in the build/web
directory and can be deployed to any static website hosting service.
- Chat with MCP Server
- MCP Server Market
- Auto install MCP Server
- SSE MCP Transport Support
- Auto Choose MCP Server
- Chat History
- OpenAI LLM Model
- Claude LLM Model
- OLLama LLM Model
- DeepSeek LLM Model
- RAG
- Better UI Design
- Dark/Light Theme
All features are welcome to submit, you can submit your ideas or bugs in Issues
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.
- Also you can add new MCP Server to the Market : MCP Server Market
Create a fork of mcp_server_market and add your MCP Server to the mcp_server_market.json
end of the file.
{
"mcpServers": {
"existing-mcp-servers": {},
"your-mcp-server": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/username/your-mcp-server",
"your-mcp-server"
]
}
}
}
You can send a Pull Request to the 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.
Your feedback helps us improve chatmcp and helps other users make informed decisions.
This project is licensed under the Apache License 2.0.