ChatMCP

Instalação

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

¹ Notas para Linux:

• Consulte os requisitos do Linux abaixo para dependências de runtime do AppImage/DEB no Ubuntu 22.04 e 24.04
• Experiência aprimorada: As versões mais recentes incluem melhor suporte a tema escuro, armazenamento de dados unificado seguindo a Especificação de Diretório Base XDG, e um layout de UI otimizado para ambientes desktop Linux está planejado
• Testado nas principais distribuições: Ubuntu, Fedora, Arch Linux, openSUSE

² Nota: A versão Web roda inteiramente no seu navegador com armazenamento local para histórico de conversas e configurações.

Documentação

Você também pode usar o DeepWiki para obter mais informações sobre o chatmcp. O DeepWiki é uma plataforma alimentada por IA que transforma qualquer repositório público do GitHub em uma wiki totalmente interativa e fácil de entender. Ao analisar código, documentação e arquivos de configuração, ele cria explicações claras, diagramas interativos e até permite perguntas e respostas em tempo real com a IA.

Pré-visualização

Sincronização de Dados

Os aplicativos ChatMCP podem sincronizar dados dentro da mesma rede local

Uso

Certifique-se de ter instalado uvx ou npx no seu sistema

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

Requisitos do Linux (Ubuntu 22.04 e 24.04)

Para executar o ChatMCP AppImage/DEB no Ubuntu e derivados, instale os seguintes pacotes de runtime:

• 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
• Utilitários X11 e SQLite: libx11-6, xdg-utils, libsqlite3-0

Comandos de instalação:

• Ubuntu 22.04:

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:

sudo apt install -y libfuse2 libgtk-3-0 libegl1 libgles2 libgl1-mesa-dri libglx-mesa0 libx11-6 xdg-utils libsqlite3-0 libsqlite3-dev

Opcional (recomendado): mesa-vulkan-drivers, mesa-utils (para diagnósticos como glxinfo)

1. Configure sua Chave de API LLM e Endpoint na página Setting
2. Instale o MCP Server na página MCP Server
3. Converse com o MCP Server

• servidor mcp stdio

• servidor mcp sse

Armazenamento de Dados

O ChatMCP segue as melhores práticas específicas de cada plataforma para armazenamento de dados:

Locais de Armazenamento

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:

• Diretório de Documentos do Aplicativo

Estrutura de Arquivos

Todas as plataformas armazenam dados em uma estrutura de diretórios unificada:

• Pasta logs - Logs do aplicativo
• chatmcp.db - Arquivo de banco de dados principal contendo histórico de conversas e mensagens
• shared_preferences.json - Configurações e preferências do aplicativo
• mcp_server.json - Configurações do servidor MCP

Redefinir Dados do Aplicativo

Para redefinir completamente o aplicativo (excluir todo o histórico de conversas, configurações e definições):

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

Desenvolvimento

Instalar Flutter

Para desenvolver ou executar o ChatMCP, você precisa ter o Flutter instalado. Siga o guia oficial de instalação do Flutter para sua plataforma.

• Baixar Flutter

Após a instalação, verifique com:

flutter --version

Formatação de Código Obrigatória e Hook de Pré-commit

Para manter um estilo de código consistente entre os colaboradores, este repositório aplica a formatação Dart em cada commit.

• O repositório inclui um hook Git versionado em .githooks/pre-commit.
• No commit, ele executa dart format ., re-adiciona os arquivos alterados e, em seguida, realiza uma verificação sem saída para garantir que nada permaneça sem formatação.
• Commits que não estiverem devidamente formatados serão rejeitados localmente; além disso, o CI falhará em PRs não formatados.

Configuração rápida (uma vez por clone):

make setup-git-hooks

Configuração manual (alternativa):

git config core.hooksPath .githooks
chmod +x .githooks/pre-commit

Requisitos (pelo menos um deve estar disponível no PATH):

• Dart SDK, ou
• Flutter (inclui Dart)

Exemplos:

• macOS/Linux (Flutter):

  export PATH="$PATH:$HOME/flutter/bin"
  which flutter && flutter --version
  which dart && dart --version
  

• macOS/Linux (Dart SDK):

  export PATH="$PATH:$HOME/dart-sdk/bin"
  which dart && dart --version
  

• Windows (PowerShell): Adicione C:\\src\\flutter\\bin (ou seu caminho do Flutter) ao PATH do Usuário/Sistema. Valide via:

  where flutter
  where dart
  

Nota para IDE: Após alterar o PATH, reinicie sua IDE para que as operações de VCS (commit) herdem o ambiente atualizado.

Aplicação no CI:

• Um workflow do GitHub Actions check-format executa dart format --output=none --set-exit-if-changed . em push/PR e falhará se algum arquivo não estiver formatado.

Política:

• Não ignore hooks (por exemplo, --no-verify). Essas alterações falharão no CI e precisarão ser reformatadas de qualquer forma.

Clonar e Executar Localmente

# 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

Versão Web

Desenvolvimento Local

# 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

Compilar Versão Web

# Build production version
flutter build web

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

Implantar no 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

Após a compilação, os arquivos estarão no diretório build/web e poderão ser implantados em qualquer serviço de hospedagem de sites estáticos.

Recursos

• Conversar com MCP Server
• Mercado de MCP Server
• Instalação automática de MCP Server
• Suporte a Transporte SSE MCP
• Seleção automática de MCP Server
• Histórico de Conversas
• Modelo LLM OpenAI
• Modelo LLM Claude
• Modelo LLM OLLama
• Modelo LLM DeepSeek
• RAG
• Melhor Design de UI
• Tema Escuro/Claro

Todos os recursos são bem-vindos para envio; você pode enviar suas ideias ou bugs em Issues

Mercado de MCP Server

Você pode instalar MCP Servers do Mercado de MCP Server. O Mercado de MCP Server é uma coleção de MCP Servers; você pode usá-lo para conversar com diferentes dados.

• Você também pode adicionar novos MCP Servers ao Mercado: MCP Server Market

Crie um fork de mcp_server_market e adicione seu MCP Server ao final do arquivo mcp_server_market.json.

{
    "mcpServers": {
        "existing-mcp-servers": {},
        "your-mcp-server": {
              "command": "uvx",
              "args": [
                  "--from",
                  "git+https://github.com/username/your-mcp-server",
                  "your-mcp-server"
            ]
        }
    }
}

Você pode enviar um Pull Request para o repositório mcp_server_market para adicionar seu MCP Server ao Mercado. Após seu PR ser mesclado, seu MCP Server estará disponível no Mercado e outros usuários poderão usá-lo imediatamente.

Seu feedback nos ajuda a melhorar o chatmcp e ajuda outros usuários a tomar decisões informadas.

Agradecimentos

• MCP
• mcp-cli

Licença

Este projeto está licenciado sob a Apache License 2.0.

Histórico de Estrelas