chatmcp
- agent-framework
ChatMCP is an AI chat client implementing the Model Context Protocol (MCP).
About
What is chatmcp?
Chatmcp is a cross-platform AI chat client that integrates with the Model Context Protocol (MCP) to allow users to chat with MCP servers. It runs on macOS, Windows, Linux, iOS, and Android, and supports multiple LLM models including OpenAI, Claude, Ollama, and DeepSeek.
How to use chatmcp?
After installing chatmcp, ensure you have uvx or npx installed on your system. Configure your LLM API key and endpoint in the Settings page, then install an MCP server from the MCP Server page (supports stdio and SSE transports). Finally, start chatting with the MCP server. Installation details (brew, curl, apt) are provided per platform.
Key features of chatmcp
- Chat with MCP servers via stdio or SSE transport
- Supports OpenAI, Claude, Ollama, and DeepSeek LLM models
- Built-in chat history and automatic MCP server selection
- Dark / Light theme
- Artifact display, thinking mode, and image generation
- LaTeX, HTML preview, and Mermaid diagram rendering
Use cases of chatmcp
- Connect to custom MCP servers to query local databases or APIs via natural language
- Rapidly prototype and test MCP server interactions with different LLM backends
- Use chatmcp as a unified AI assistant that can run on multiple devices (desktop and mobile)
- Leverage MCP server market to discover and install pre-built data connectors
FAQ from chatmcp
What platforms does chatmcp support?
Chatmcp supports macOS, Windows, Linux, iOS, and Android.
Which MCP transport protocols are supported?
Both stdio and SSE (Server-Sent Events) transport protocols are supported.
Does chatmcp require any system dependencies?
Yes, Linux requires libsqlite3-0 and libsqlite3-dev. On all platforms, uvx or npx must be available.
What is the license for chatmcp?
Chatmcp is licensed under the Apache License 2.0.
Are all features implemented?
Some features like MCP Server Market, auto install of MCP servers, RAG, and better UI are still in development (marked as unchecked). See the README for the full list.
Details
- Author
- daodao97
- GitHub stars
- 1,648
- Category
- agent-framework
- Repository
- daodao97/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 AI Chat Client
</div>
Install
| macOS | Windows | Linux | iOS | Android |
|-------|---------|-------|------|---------|
| Release | Release | Release ¹ | TestFlight | Release |
¹ Note: On Linux you need to install libsqlite3-0 libsqlite3-dev, as this dependency needs it https://pub.dev/packages/sqflite_common_ffi
sudo apt-get install libsqlite3-0 libsqlite3-dev
Preview
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
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
Debug
- logs & data
macOS:
~/Library/Application Support/ChatMcp
Windows:
%APPDATA%\ChatMcp
Linux:
~/.local/share/ChatMcp
Mobile:
- Application Documents Directory
reset app can use this command
macOS:
rm -rf ~/Library/Application\ Support/ChatMcp
Windows:
rd /s /q "%APPDATA%\ChatMcp"
Linux:
rm -rf ~/.local/share/ChatMcp
Development
flutter pub get
flutter run -d macos
Features
- [x] Chat with MCP Server
- [ ] MCP Server Market
- [ ] Auto install MCP Server
- [x] SSE MCP Transport Support
- [x] Auto Choose MCP Server
- [x] Chat History
- [x] OpenAI LLM Model
- [x] Claude LLM Model
- [x] OLLama LLM Model
- [x] DeepSeek LLM Model
- [ ] RAG
- [ ] Better UI Design
- [x] 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.
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.
