MCPMate

MCPMate es un

Documentación

MCPMate

English | 中文 | 日本語

MCPMate dashboard

Tu socio progresivo de gestión de MCP.

Release Downloads License Platform Rust MCP Spec


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.

EtapaQué obtienes
InicioImporta servidores, verifica llamadas y consulta el estado en un solo lugar
CrecePerfiles de escena para programación, escritura o investigación; cambia el conjunto completo de herramientas con un clic
AjustaRecorte por cliente desde una biblioteca de servidores compartida: menos desorden, menor uso de tokens
Elige cómo conectarteTransparente (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

🤔 ¿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 &amp; Security<br/><small>Secure Store · Structured Logs · SQLite Catalog</small>"]
        UP --> PROF --> SEC
    end

    subgraph cfg ["🔧 Client Config"]
        direction TB
        DET["Detection &amp; 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ísticaDescripción
Recorte basado en perfilesOrganiza servidores MCP en perfiles de escena, aplicación y dinámicos. Cambia al instante sin reiniciar servicios.
Soporte multi-clienteDetecta, configura y gestiona Claude Desktop, Cursor, Zed, Codex y clientes definidos por el usuario.
Gobernanza dinámica de clientesGobernanza 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 MarketExplora 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 ManagerInstala y gestiona los runtimes de Node.js, uv (Python) y Bun utilizados por los servidores MCP locales.
Almacén seguro y custodia OAuthMantiene 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 capacidadesInstantáneas versionadas de capacidades en SQLite con un LRU acotado en proceso para lecturas rápidas de protocolo y gestión.
Registros estructuradosPá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 navegadorLa 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 herramientasEjecuta 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

CapaTecnología
Proxy / BackendRust, tokio, rmcp, SQLite (catálogo de configuración y capacidades), LRU en proceso
PanelReact, Vite, Zustand, React Query, Radix UI
EscritorioTauri 2, bandeja del sistema, notificaciones nativas
BridgeBinario Rust, conversión stdio a HTTP
Runtime ManagerMulti-runtime (Node.js, uv, Bun)
ProtocoloMCP 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

  1. Pulido de descubrimiento a instalación — flujos más ajustados de extensión de navegador, Market, README y metadatos de origen
  2. Copia de seguridad y restauración de configuración basada en cuenta
  3. Perfiles empaquetados en modo skills
  4. 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:

  1. Lee AGENTS.md para las pautas de desarrollo
  2. Abre un issue para discutir cambios significativos
  3. Envía pull requests contra la rama main

📄 Licencia

GNU Affero General Public License v3.0 (AGPL-3.0)