chatmcp

Install

macOS	Windows	Linux	iOS	Android	Web
Release	Release	Release ¹	TestFlight	Release	GitHub Pages ²

¹ Linux Notes:

Install required dependencies: sudo apt install libsqlite3-0 libsqlite3-dev on Debian/Ubuntu and derivatives
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

Artifact Display Thinking Mode Generate Image $LaTeX Support$ HTML Preview Mermaid Diagram MCP Workflow MCP InMemory MCP Tools LLM Provider MCP Stdio MCP SSE

Data Sync

ChatMCP applications can sync data within the same local area network

Data sync

Usage

Make sure you have installed uvx or npx in your system

MacOS

# uvx
brew install uv

# npx
brew install node

Linux

# 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

stdio mcp server
sse mcp server

Data Storage

ChatMCP follows platform-specific best practices for data storage:

Storage Locations

macOS:

~/Library/Application Support/ChatMcp/

Windows:

%APPDATA%\ChatMcp\

Linux:

~/.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.db - Main database file containing chat history and messages
shared_preferences.json - Application settings and preferences
mcp_server.json - MCP server configurations

Reset Application Data

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
rm -rf ~/.local/share/run.daodao.chatmcp

Development

Install Flutter

To develop or run ChatMCP, you need to have Flutter installed.
Follow the official Flutter installation guide for your platform.

Download Flutter

After installing, verify with:

flutter --version

Clone and Run Locally

# Clone the repository
git clone https://github.com/daodao97/chatmcp.git
cd chatmcp

# Install dependencies
flutter pub get

# Run on macOS
flutter run -d macos

# Run on Linux (requires Flutter desktop support enabled)
flutter run -d linux

# Build release for Linux
flutter build linux

Web Version

Local Development

# Install dependencies
flutter pub get

# Run Web version locally
flutter run -d chrome
# Or specify port
flutter run -d chrome --web-port 8080
# Or run as web-serer for other browsers.
flutter run -d web-server

Build Web Version

# Build production version
flutter build web

# Build with base path (for deploying to subdirectory)
flutter build web --base-href /chatmcp/

Deploy to GitHub Pages

# 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.

Features

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

MCP Server Market

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.

daodao97/chatmcp

星标增长

证据时间轴