MCPMate

MCPMate é um centro de gerenciamento abrangente do Model Context Protocol

Documentação

MCPMate

MCPMate dashboard

Seu parceiro progressivo de gerenciamento MCP.

Importe MCP uma vez. Comece simples e adicione perfis, ferramentas por cliente e modos de configuração conforme seu fluxo de trabalho cresce.

MCPMate é um assistente local-first que cresce com você — não apenas mais um editor de arquivos de configuração.

MCPMate fica entre seus aplicativos de IA e servidores MCP para que você gerencie conexões uma vez e envie as ferramentas certas para cada aplicativo. Funciona com Claude Desktop, Cursor, Codex, Zed, VS Code, ferramentas CLI e outros clientes que seguem o formato padrão de configuração MCP.

Fácil de começar, feito para escalar: uma importação com baixo atrito; a mesma configuração continua funcionando à medida que o MCP se espalha por mais clientes, servidores e cenários — sem troca de produto, sem ritual de reinicialização.

Etapa	O que você obtém
Início	Importe servidores, verifique chamadas e veja a saúde em um só lugar
Crescer	Perfis de cena para codificação, escrita ou pesquisa; alterne o conjunto completo de ferramentas com um clique
Ajustar	Ajuste por cliente a partir de uma biblioteca de servidores compartilhada — menos bagunça, menor uso de tokens
Escolha como conectar	Transparent (saída de configuração nativa), Hosted (controle de proxy durável) ou Unify (superfície de ferramentas pequena, descoberta sob demanda)

Site ao vivo: mcp.umate.ai · Documentação: mcp.umate.ai/docs

📑 Sumário

MCPMate

🤔 Por que MCPMate?

Gerenciar MCP em várias ferramentas de IA (Claude Desktop, Cursor, Zed, Codex e clientes personalizados) fica bagunçado rapidamente:

·	Ponto de Dor	·	Abordagem do MCPMate
❌	A mesma configuração MCP é copiada manualmente para cada cliente	✅	Configure uma vez, use em qualquer lugar — servidores, variáveis de ambiente e conexões ficam em um só lugar
❌	Alternar entre codificação, escrita e pesquisa significa reconfigurar cada aplicativo	✅	Alterne cenários instantaneamente — perfis de cena trocam o conjunto completo de ferramentas com um clique
❌	Cada cliente vê todas as ferramentas, desperdiçando tokens e poluindo a interface	✅	Cada cliente vê o que deve — uma biblioteca, visibilidade diferente por aplicativo
❌	Um único estilo de integração não atende a todos os clientes	✅	Modos de configuração Hosted, Unify ou Transparent para o nível de controle que você precisa
❌	Difícil saber se os serviços estão prontos ou se as chamadas estão funcionando	✅	Veja e verifique — inspetor, logs estruturados e painel em um único plano de controle local
❌	Muitos processos MCP competem por RAM e handles	✅	Um único proxy agrega servidores upstream com pooling de conexões

🔄 Como 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 fica entre seus clientes de IA e servidores MCP. Para cada aplicativo, parece um endpoint MCP normal — sem interrupção do fluxo de trabalho — enquanto perfis, políticas e roteamento permanecem na camada intermediária. O Bridge adapta clientes somente stdio (como Claude Desktop) ao proxy HTTP. O Profile Engine decide quais ferramentas cada cliente vê — perfis de cena para contexto de fluxo de trabalho, perfis de aplicativo para ajuste por cliente e perfis dinâmicos que se ajustam em tempo de execução. Os modos de configuração Transparent, Hosted e Unify permitem escolher o quanto o MCPMate fica no caminho versus escrever configurações nativas do cliente.

🚀 Principais Recursos

Recurso	Descrição
Ajuste Baseado em Perfis	Organize servidores MCP em perfis de cena, aplicativo e dinâmicos. Alterne instantaneamente sem reiniciar serviços.
Suporte a Múltiplos Clientes	Detecte, configure e gerencie Claude Desktop, Cursor, Zed, Codex e clientes definidos pelo usuário.
Governança Dinâmica de Clientes	Governança baseada em banco de dados com políticas de Permitir/Negar. Sem arquivos de modelo estáticos. Destinos de configuração verificados são necessários para gravações.
Integração com o Market	Navegue e instale a partir do registro oficial MCP sem sair do aplicativo. As visualizações de detalhes podem mostrar contexto do README do GitHub, metadados de origem e autorização OAuth.
Runtime Manager	Instala e gerencia os runtimes Node.js, uv (Python) e Bun usados por servidores MCP locais.
Armazenamento Seguro e Custódia OAuth	Mantém segredos locais, tokens OAuth e segredos de cliente em custódia criptografada com limpeza de ciclo de vida e orientação para estados degradados.
OAuth 2.0 Upstream (PKCE)	Suporta fluxos OAuth 2.0 upstream com PKCE para servidores MCP HTTP Streamable, incluindo descoberta de metadados, tratamento de callbacks e fluxos de reconexão.
Catálogo de Capacidades Transacionais	Instantâneos de capacidade SQLite versionados com um LRU limitado em processo para leituras rápidas de protocolo e gerenciamento.
Logs Estruturados	Página de Logs dedicada com paginação baseada em cursor, metadados de ator/alvo/ação e acesso à API REST.
Extensão de Navegador	A extensão Chrome/Edge navega por Servidores, Clientes e Portais e importa trechos MCP, entradas MCP do GitHub e entradas do Cursor.directory via `mcpmate://import/server`.
Inspetor de Ferramentas	Execute chamadas rápidas de ferramentas contra servidores conectados e inspecione respostas estruturadas a partir do console.

🛠️ Componentes Principais

Proxy

Um servidor proxy MCP de alto desempenho que se conecta a vários servidores MCP e agrega suas ferramentas. Implementa protocolos de transporte stdio e HTTP Streamable alinhados com a especificação MCP atual. Aceita servidores configurados com SSE legado e os normaliza automaticamente para HTTP Streamable para compatibilidade retroativa.

Bridge

Um componente de ponte leve que converte o protocolo stdio para transporte HTTP sem modificar o cliente. Herda automaticamente todas as funções e ferramentas do serviço HTTP. Configuração mínima — requer apenas o endereço do serviço.

Runtime Manager

Instala e gerencia runtimes usados por servidores MCP locais. Suporta Node.js, uv (Python) e Bun com rastreamento de progresso de download e configuração automática de variáveis de ambiente.

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

Desktop App

Aplicativo desktop multiplataforma construído com Tauri 2. Interface gráfica completa para gerenciar servidores MCP, perfis e ferramentas com monitoramento em tempo real, detecção inteligente de clientes e integração com a bandeja do sistema. As versões desktop para macOS, Windows e Linux estão atualmente disponíveis como versões Beta.

Logs

Log operacional estruturado para atividade do proxy MCP. Coleta operações MCP e alterações do lado de gerenciamento em uma linha do tempo estruturada com paginação baseada em cursor, APIs REST e uma página de Logs dedicada na interface do painel.

⚡ Início Rápido

Opção A: Baixar o Aplicativo Desktop (Recomendado)

Baixe a versão mais recente para sua plataforma em GitHub Releases.

Nota: as versões para macOS são assinadas e notarizadas para reduzir avisos de segurança do sistema e melhorar a confiança no pacote.

Usuários de macOS e Linux também podem instalar o cask Beta do Homebrew com brew install --cask loocor/tap/mcpmate@beta. Consulte o Guia de instalação para atualizações e etapas de desinstalação.

Opção B: Compilar a partir do Código-Fonte

Pré-requisitos: Rust 1.85+, Node.js 18+ ou Bun, SQLite 3

1. Clone e Compile o Backend

git clone https://github.com/loocor/MCPMate.git
cd MCPMate/backend
cargo build --release

2. Inicie o Proxy

cargo run --release

O proxy inicia com:

API REST em http://localhost:8080
Endpoint MCP em http://localhost:8000

3. Inicie o Painel

cd ../board
bun install
bun run dev

Painel disponível em http://localhost:5173.

Opção C: Demonstração Online

Em breve. Um ambiente online permitirá explorar o painel, os perfis e a configuração de clientes sem uma instalação local.

🧰 Pilha Tecnológica

Camada	Tecnologia
Proxy / Backend	Rust, tokio, rmcp, SQLite (configuração e catálogo de capacidades), LRU em processo
Dashboard	React, Vite, Zustand, React Query, Radix UI
Desktop	Tauri 2, bandeja do sistema, notificações nativas
Bridge	Binário Rust, conversão stdio-para-HTTP
Runtime Manager	Multi-runtime (Node.js, uv, Bun)
Protocolo	MCP 2025-11-25, stdio + HTTP Streamable

🚢 Modos de Implantação

Modo integrado (desktop) — Tauri agrupa backend + painel para operação local all-in-one
Modo separado (servidor principal + UI) — Execute o backend de forma independente e conecte o painel web ou o shell desktop a esse serviço principal
Flexibilidade do modo cliente — Clientes gerenciados podem continuar usando fluxos de trabalho hospedados/transparentes enquanto o plano de controle é executado remotamente

🔧 Desenvolvimento

# Run all checks
./scripts/check

# Start backend + board together
./scripts/dev-all

Consulte AGENTS.md para diretrizes de desenvolvimento, padrões de codificação e fluxo de trabalho de contribuição.

🗺️ Roteiro

Polimento de descoberta até instalação — fluxos mais integrados de extensão de navegador, Market, README e metadados de origem
Backup e restauração de configuração baseados em conta
Perfis empacotados em modo skills
Inspetor autônomo — um caminho focado para conexão de servidor MCP, descoberta de capacidades e verificação de chamadas

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

Leia AGENTS.md para diretrizes de desenvolvimento
Abra uma issue para discutir mudanças significativas
Envie pull requests para o branch main

📄 Licença

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