Labsco
daodao97 logo

ChatMCP

โ˜… 2,200

from daodao97

A cross-platform AI chat client supporting desktop, mobile, and web platforms.

๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅโœ“ VerifiedFreeAdvanced setup
#automation#database#devops#git#maps

chatmcp

Cross-platform Macos | Windows | Linux | iOS | Android | Web AI Chat Client

English | ็ฎ€ไฝ“ไธญๆ–‡ | Tรผrkรงe

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

Data Storage

ChatMCP follows platform-specific best practices for data storage:

Storage Locations

macOS:

Copy & paste โ€” that's it
~/Library/Application Support/ChatMcp/

Windows:

Copy & paste โ€” that's it
%APPDATA%\ChatMcp\

Linux:

Copy & paste โ€” that's it
~/.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:

Copy & paste โ€” that's it
rm -rf ~/Library/Application\ Support/ChatMcp

Windows:

Copy & paste โ€” that's it
rd /s /q "%APPDATA%\ChatMcp"

Linux:

Copy & paste โ€” that's it
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.

After installing, verify with:

Copy & paste โ€” that's it
flutter --version

Mandatory Code Formatting and Pre-commit Hook

To keep a consistent code style across contributors, this repository enforces Dart formatting on every commit.

  • The repository ships a versioned Git hook at .githooks/pre-commit.

  • On commit, it runs dart format ., re-adds changed files, and then performs a no-output check to ensure nothing remains unformatted.

  • Commits that are not properly formatted will be rejected locally; in addition, CI will fail unformatted PRs.

Quick setup (once per clone):

Copy & paste โ€” that's it
make setup-git-hooks

Manual setup (alternative):

Copy & paste โ€” that's it
git config core.hooksPath .githooks
chmod +x .githooks/pre-commit

Requirements (at least one must be available on PATH):

  • Dart SDK, or

  • Flutter (bundles Dart)

Examples:

  • macOS/Linux (Flutter):
Copy & paste โ€” that's it
export PATH="$PATH:$HOME/flutter/bin"
which flutter && flutter --version
which dart && dart --version
  • macOS/Linux (Dart SDK):
Copy & paste โ€” that's it
export PATH="$PATH:$HOME/dart-sdk/bin"
which dart && dart --version
  • Windows (PowerShell): Add C:\\src\\flutter\\bin (or your Flutter path) to the User/System PATH. Validate via:
Copy & paste โ€” that's it
where flutter
where dart

IDE note: After changing PATH, restart your IDE so VCS operations (commit) inherit the updated environment.

CI enforcement:

  • A GitHub Actions workflow check-format runs dart format --output=none --set-exit-if-changed . on push/PR and will fail if any file is not formatted.

Policy:

  • Do not bypass hooks (e.g., --no-verify). Such changes will fail in CI and must be reformatted anyway.

Clone and Run Locally

Copy & paste โ€” that's it
# 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

Copy & paste โ€” that's it
# 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

Copy & paste โ€” that's it
# Build production version
flutter build web

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

Deploy to GitHub Pages

Copy & paste โ€” that's it
# 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.

Create a fork of mcp_server_market and add your MCP Server to the mcp_server_market.json end of the file.

Copy & paste โ€” that's it
{
 "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.

Thanks

License

This project is licensed under the Apache License 2.0.

Star History