ChatMCP

Instalación

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

¹ Notas de Linux:

• Consulta los requisitos de Linux a continuación para las dependencias de ejecución de AppImage/DEB en Ubuntu 22.04 y 24.04
• Experiencia mejorada: Las últimas versiones incluyen mejor soporte de tema oscuro, almacenamiento de datos unificado siguiendo la Especificación de Directorio Base XDG, y se planea una optimización del diseño de la interfaz para entornos de escritorio Linux
• Probado en las principales distribuciones: Ubuntu, Fedora, Arch Linux, openSUSE

² Nota: La versión web se ejecuta completamente en tu navegador con almacenamiento local para el historial de chat y la configuración.

Documentación

Además, puedes usar DeepWiki para obtener más información sobre chatmcp. DeepWiki es una plataforma impulsada por IA que transforma cualquier repositorio público de GitHub en una wiki totalmente interactiva y fácil de entender. Al analizar código, documentación y archivos de configuración, crea explicaciones claras, diagramas interactivos e incluso permite preguntas y respuestas en tiempo real con la IA.

Vista Previa

Sincronización de Datos

Las aplicaciones ChatMCP pueden sincronizar datos dentro de la misma red de área local

Uso

Asegúrate de tener instalado uvx o npx en tu 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 de Linux (Ubuntu 22.04 y 24.04)

Para ejecutar ChatMCP AppImage/DEB en Ubuntu y derivados, instala los siguientes paquetes de ejecución:

• AppImage (FUSE): libfuse2
• GTK 3: libgtk-3-0
• Gráficos/EGL:
  • Ubuntu 22.04: libegl1-mesa, libgles2, libgl1-mesa-dri, libglx-mesa0
  • Ubuntu 24.04: libegl1, libgles2, libgl1-mesa-dri, libglx-mesa0
• Utilidades X11 y SQLite: libx11-6, xdg-utils, libsqlite3-0

Comandos de instalación:

• 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. Configura tu Clave de API de LLM y el Endpoint en la página Setting
2. Instala el Servidor MCP desde la página MCP Server
3. Chatea con el Servidor MCP

• Servidor MCP stdio

• Servidor MCP sse

Almacenamiento de Datos

ChatMCP sigue las mejores prácticas específicas de cada plataforma para el almacenamiento de datos:

Ubicaciones de Almacenamiento

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

Móvil:

• Directorio de Documentos de la Aplicación

Estructura de Archivos

Todas las plataformas almacenan datos en una estructura de directorio unificada:

• Carpeta logs - Registros de la aplicación
• chatmcp.db - Archivo de base de datos principal que contiene el historial de chat y mensajes
• shared_preferences.json - Configuración y preferencias de la aplicación
• mcp_server.json - Configuraciones del servidor MCP

Restablecer Datos de la Aplicación

Para restablecer completamente la aplicación (eliminar todo el historial de chat, configuración y ajustes):

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

Desarrollo

Instalar Flutter

Para desarrollar o ejecutar ChatMCP, necesitas tener Flutter instalado. Sigue la guía oficial de instalación de Flutter para tu plataforma.

• Descargar Flutter

Después de instalar, verifica con:

flutter --version

Formato de Código Obligatorio y Hook de Pre-commit

Para mantener un estilo de código consistente entre los colaboradores, este repositorio aplica el formato Dart en cada commit.

• El repositorio incluye un hook de Git versionado en .githooks/pre-commit.
• Al hacer commit, ejecuta dart format ., vuelve a agregar los archivos modificados y luego realiza una verificación sin salida para asegurarse de que nada quede sin formatear.
• Los commits que no estén correctamente formateados serán rechazados localmente; además, CI fallará en los PRs sin formato.

Configuración rápida (una vez por clon):

make setup-git-hooks

Configuración manual (alternativa):

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

Requisitos (al menos uno debe estar disponible en PATH):

• Dart SDK, o
• Flutter (incluye Dart)

Ejemplos:

• 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): Agrega C:\\src\\flutter\\bin (o tu ruta de Flutter) al PATH de Usuario/Sistema. Valida mediante:

  where flutter
  where dart
  

Nota del IDE: Después de cambiar el PATH, reinicia tu IDE para que las operaciones de VCS (commit) hereden el entorno actualizado.

Aplicación en CI:

• Un flujo de trabajo de GitHub Actions check-format ejecuta dart format --output=none --set-exit-if-changed . en push/PR y fallará si algún archivo no está formateado.

Política:

• No omitas los hooks (por ejemplo, --no-verify). Dichos cambios fallarán en CI y deberán reformatearse de todos modos.

Clonar y Ejecutar 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

Versión Web

Desarrollo 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 Versión Web

# Build production version
flutter build web

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

Desplegar en 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

Después de compilar, los archivos estarán en el directorio build/web y podrán desplegarse en cualquier servicio de alojamiento de sitios web estáticos.

Características

• Chatear con Servidor MCP
• Mercado de Servidores MCP
• Instalación automática de Servidores MCP
• Soporte de Transporte SSE MCP
• Selección automática de Servidor MCP
• Historial de Chat
• Modelo LLM OpenAI
• Modelo LLM Claude
• Modelo LLM OLLama
• Modelo LLM DeepSeek
• RAG
• Mejor Diseño de Interfaz
• Tema Oscuro/Claro

Todas las características son bienvenidas; puedes enviar tus ideas o errores en Issues

Mercado de Servidores MCP

Puedes instalar Servidores MCP desde el Mercado de Servidores MCP, que es una colección de Servidores MCP; puedes usarlo para chatear con diferentes datos.

• También puedes agregar nuevos Servidores MCP al Mercado: Mercado de Servidores MCP

Crea un fork de mcp_server_market y agrega tu Servidor MCP al final del archivo 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"
            ]
        }
    }
}

Puedes enviar un Pull Request al repositorio mcp_server_market para agregar tu Servidor MCP al Mercado. Después de que tu PR se fusione, tu Servidor MCP estará disponible en el Mercado y otros usuarios podrán usarlo de inmediato.

Tus comentarios nos ayudan a mejorar chatmcp y ayudan a otros usuarios a tomar decisiones informadas.

Agradecimientos

• MCP
• mcp-cli

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0.

Historial de Estrellas