MCPMate
MCPMate es un
Documentación
MCPMate
Tu socio progresivo de gestión de MCP.
Importa MCP una vez. Empieza simple, luego añade perfiles, herramientas por cliente y modos de configuración a medida que tu flujo de trabajo crece.
MCPMate es un asistente local-first que crece contigo, no solo otro editor de archivos de configuración.
MCPMate se sitúa entre tus aplicaciones de IA y los servidores MCP para que gestiones las conexiones una sola vez y envíes las herramientas adecuadas a cada aplicación. Funciona con Claude Desktop, Cursor, Codex, Zed, VS Code, herramientas CLI y otros clientes que siguen el formato estándar de configuración de MCP.
Fácil de empezar, diseñado para escalar: una sola importación con baja fricción; la misma configuración sigue siendo válida a medida que MCP se extiende a más clientes, servidores y escenarios, sin cambiar de producto ni rituales de reinicio.
| Etapa | Qué obtienes |
|---|---|
| Inicio | Importa servidores, verifica llamadas y consulta el estado en un solo lugar |
| Crece | Perfiles de escena para programación, escritura o investigación; cambia el conjunto completo de herramientas con un clic |
| Ajusta | Recorte por cliente desde una biblioteca de servidores compartida: menos desorden, menor uso de tokens |
| Elige cómo conectarte | Transparente (salida de configuración nativa), Alojado (control de proxy duradero) o Unifica (superficie de herramientas pequeña, descubrimiento bajo demanda) |
Sitio en vivo: mcp.umate.ai · Documentación: mcp.umate.ai/docs
📑 Tabla de contenidos
- MCPMate
🤔 ¿Por qué MCPMate?
Gestionar MCP en múltiples herramientas de IA (Claude Desktop, Cursor, Zed, Codex y clientes personalizados) se vuelve complicado rápidamente:
| · | Punto de dolor | · | Enfoque de MCPMate |
|---|---|---|---|
| ❌ | La misma configuración de MCP se copia manualmente en cada cliente | ✅ | Configura una vez, usa en todas partes — servidores, variables de entorno y conexiones en un solo lugar |
| ❌ | Cambiar entre programación, escritura e investigación implica reconfigurar cada aplicación | ✅ | Cambia de escenario al instante — los perfiles de escena intercambian el conjunto completo de herramientas con un clic |
| ❌ | Cada cliente ve todas las herramientas, desperdiciando tokens y saturando la interfaz | ✅ | Cada cliente ve lo que debe — una biblioteca, visibilidad diferente por aplicación |
| ❌ | Un solo estilo de integración no se adapta a todos los clientes | ✅ | Alojado, Unifica o Transparente: modos de configuración para el nivel de control que necesitas |
| ❌ | Es difícil saber si los servicios están listos o si las llamadas tienen éxito | ✅ | Míralo, verifícalo — inspector, registros estructurados y panel en un único plano de control local |
| ❌ | Muchos procesos MCP compiten por RAM y manejadores | ✅ | Un único proxy agrega servidores upstream con agrupación de conexiones |
🔄 Cómo funciona
flowchart LR
subgraph mgmt ["🖥️ Management"]
APP["Tauri Desktop"]
DASH["Web Dashboard"]
end
subgraph proxy ["⚙️ MCPMate Proxy"]
direction TB
UP["Upstream Mgmt<br/><small>Connection Pool · OAuth 2.0 + PKCE</small>"]
PROF["Profile Engine<br/><small>Scene · App · Dynamic</small>"]
SEC["Event Logs & Security<br/><small>Secure Store · Structured Logs · SQLite Catalog</small>"]
UP --> PROF --> SEC
end
subgraph cfg ["🔧 Client Config"]
direction TB
DET["Detection & Adapter"]
MODES["Modes<br/><small>Transparent · Hosted · Unify</small>"]
DET --> MODES
end
subgraph clients ["📱 AI Clients"]
C["Cursor · VS Code · Zed · ..."]
end
subgraph upstream ["☁️ Upstream MCP Servers"]
S["uvx · bunx · npx<br/>SSE · Streamable HTTP"]
end
subgraph market ["🛒 MCP Marketplace"]
M["Official Registry"]
end
APP -->|"API"| proxy
DASH -->|"API"| proxy
market -.->|"Install"| proxy
upstream -->|"stdio / HTTP"| proxy
proxy -->|"Bridge / HTTP"| cfg
MODES --> clients
classDef mgmt fill:#e3f2fd,stroke:#1565c0,color:#000
classDef proxy fill:#fff3e0,stroke:#e65100,color:#000
classDef cfg fill:#e8f5e9,stroke:#2e7d32,color:#000
classDef clients fill:#fce4ec,stroke:#c62828,color:#000
classDef upstream fill:#f3e5f5,stroke:#6a1b9a,color:#000
classDef market fill:#fff9c4,stroke:#f9a825,color:#000
class APP,DASH mgmt
class UP,PROF,SEC proxy
class DET,MODES cfg
class C clients
class S upstream
class M market
MCPMate se sitúa entre tus clientes de IA y los servidores MCP. Para cada aplicación parece un endpoint MCP normal, sin interrumpir el flujo de trabajo, mientras que los perfiles, las políticas y el enrutamiento permanecen en la capa intermedia. El Bridge adapta los clientes solo-stdio (como Claude Desktop) al proxy HTTP. El Profile Engine decide qué herramientas ve cada cliente: perfiles de escena para el contexto del flujo de trabajo, perfiles de aplicación para el ajuste por cliente y perfiles dinámicos que se ajustan en tiempo de ejecución. Los modos de configuración Transparente, Alojado y Unifica te permiten elegir cuánto interviene MCPMate en la ruta frente a escribir configuraciones nativas de cliente.
🚀 Características principales
| Característica | Descripción |
|---|---|
| Recorte basado en perfiles | Organiza servidores MCP en perfiles de escena, aplicación y dinámicos. Cambia al instante sin reiniciar servicios. |
| Soporte multi-cliente | Detecta, configura y gestiona Claude Desktop, Cursor, Zed, Codex y clientes definidos por el usuario. |
| Gobernanza dinámica de clientes | Gobernanza basada en base de datos con políticas Permitir/Denegar. Sin archivos de plantilla estáticos. Se requieren destinos de configuración verificados para las escrituras. |
| Integración de Market | Explora e instala desde el registro oficial de MCP sin salir de la aplicación. Las vistas de detalle pueden mostrar contexto del README de GitHub, metadatos de origen y autorización OAuth. |
| Runtime Manager | Instala y gestiona los runtimes de Node.js, uv (Python) y Bun utilizados por los servidores MCP locales. |
| Almacén seguro y custodia OAuth | Mantiene secretos locales, tokens OAuth y secretos de cliente en custodia cifrada con limpieza del ciclo de vida y orientación para estados degradados. |
| OAuth 2.0 Upstream (PKCE) | Admite flujos OAuth 2.0 upstream con PKCE para servidores MCP Streamable HTTP, incluido el descubrimiento de metadatos, el manejo de callbacks y los flujos de reconexión. |
| Catálogo transaccional de capacidades | Instantáneas versionadas de capacidades en SQLite con un LRU acotado en proceso para lecturas rápidas de protocolo y gestión. |
| Registros estructurados | Página de Logs dedicada con paginación basada en cursor, metadatos de actor/objetivo/acción y acceso a la API REST. |
| Extensión de navegador | La extensión de Chrome/Edge explora Servers, Clients y Portals, y luego importa fragmentos MCP, entradas MCP de GitHub y entradas de Cursor.directory mediante mcpmate://import/server. |
| Inspector de herramientas | Ejecuta llamadas rápidas a herramientas contra servidores conectados e inspecciona las respuestas estructuradas desde la consola. |
🛠️ Componentes principales
Proxy
Un servidor proxy MCP de alto rendimiento que se conecta a múltiples servidores MCP y agrega sus herramientas. Implementa los protocolos de transporte stdio y Streamable HTTP alineados con la especificación MCP actual. Acepta servidores configurados con SSE heredado y los normaliza automáticamente a Streamable HTTP para compatibilidad con versiones anteriores.
Bridge
Un componente de puente ligero que convierte el protocolo stdio a transporte HTTP sin modificar el cliente. Hereda automáticamente todas las funciones y herramientas del servicio HTTP. Configuración mínima: solo requiere la dirección del servicio.
Runtime Manager
Instala y gestiona los runtimes utilizados por los servidores MCP locales. Admite Node.js, uv (Python) y Bun con seguimiento del progreso de descarga y configuración automática de variables de entorno.
runtime install node # Install Node.js for JavaScript MCP servers
runtime install uv # Install uv for Python MCP servers
runtime install bun # Install Bun
runtime list # List installed runtimes
Aplicación de escritorio
Aplicación de escritorio multiplataforma construida con Tauri 2. Interfaz gráfica completa para gestionar servidores MCP, perfiles y herramientas con monitoreo en tiempo real, detección inteligente de clientes e integración con la bandeja del sistema. Las versiones de escritorio para macOS, Windows y Linux están actualmente disponibles como versiones Beta.
Logs
Registro operativo estructurado para la actividad del proxy MCP. Recopila operaciones MCP y cambios del lado de gestión en una línea de tiempo estructurada con paginación basada en cursor, API REST y una página de Logs dedicada en la interfaz del panel.
⚡ Inicio rápido
Opción A: Descarga la aplicación de escritorio (recomendado)
Descarga la última versión para tu plataforma desde GitHub Releases.
Nota: Las versiones de macOS están firmadas y notarizadas para reducir los avisos de seguridad del sistema y mejorar la confianza en el paquete.
Los usuarios de macOS y Linux también pueden instalar la cask Beta de Homebrew con brew install --cask loocor/tap/mcpmate@beta. Consulta la guía de instalación para actualizaciones y pasos de desinstalación.
Opción B: Compilar desde el código fuente
Requisitos previos: Rust 1.85+, Node.js 18+ o Bun, SQLite 3
1. Clona y compila el backend
git clone https://github.com/loocor/MCPMate.git
cd MCPMate/backend
cargo build --release
2. Inicia el proxy
cargo run --release
El proxy se inicia con:
- API REST en
http://localhost:8080 - Endpoint MCP en
http://localhost:8000
3. Inicia el panel
cd ../board
bun install
bun run dev
Panel disponible en http://localhost:5173.
Opción C: Demo en línea
Próximamente. Un entorno en línea te permitirá explorar el panel, los perfiles y la configuración de clientes sin necesidad de una instalación local.
🧰 Stack tecnológico
| Capa | Tecnología |
|---|---|
| Proxy / Backend | Rust, tokio, rmcp, SQLite (catálogo de configuración y capacidades), LRU en proceso |
| Panel | React, Vite, Zustand, React Query, Radix UI |
| Escritorio | Tauri 2, bandeja del sistema, notificaciones nativas |
| Bridge | Binario Rust, conversión stdio a HTTP |
| Runtime Manager | Multi-runtime (Node.js, uv, Bun) |
| Protocolo | MCP 2025-11-25, stdio + Streamable HTTP |
🚢 Modos de despliegue
- Modo integrado (escritorio) — Tauri agrupa backend + panel para operación local todo-en-uno
- Modo separado (servidor central + UI) — Ejecuta el backend de forma independiente y conecta el panel web o el shell de escritorio a ese servicio central
- Flexibilidad del modo cliente — Los clientes gestionados pueden seguir usando flujos de trabajo alojados/transparentes mientras el plano de control se ejecuta de forma remota
🔧 Desarrollo
# Run all checks
./scripts/check
# Start backend + board together
./scripts/dev-all
Consulta AGENTS.md para las pautas de desarrollo, estándares de codificación y flujo de trabajo de contribución.
🗺️ Hoja de ruta
- Pulido de descubrimiento a instalación — flujos más ajustados de extensión de navegador, Market, README y metadatos de origen
- Copia de seguridad y restauración de configuración basada en cuenta
- Perfiles empaquetados en modo skills
- Inspector independiente — una ruta enfocada para la conexión de servidores MCP, el descubrimiento de capacidades y la verificación de llamadas
🤝 Contribuciones
¡Las contribuciones son bienvenidas! Por favor:
- Lee AGENTS.md para las pautas de desarrollo
- Abre un issue para discutir cambios significativos
- Envía pull requests contra la rama
main
📄 Licencia
GNU Affero General Public License v3.0 (AGPL-3.0)