agent-connector: ferramenta para implantar servidores/hooks MCP em vários CLIs de agentes de uma só vez

Problema atual: a necessidade de ajustar separadamente servidores/hooks MCP para cada CLI de agente

Ao conectar servidores MCP a vários CLIs de agente, você acaba mantendo a mesma configuração repetidamente em formatos diferentes.

Por exemplo:

• Claude Code: JSON mcpServers
• Codex: TOML [mcp_servers.*]
• Cursor: mcp.json + hooks.json
• Gemini: .gemini/settings.json

Só registrar o servidor já é trabalhoso, mas os hooks são ainda mais complexos.
Como cada host tem um modelo de eventos diferente, até o mesmo comportamento precisa ser readaptado para cada CLI.

Por isso, criei o agent-connector para reduzir essa repetição.

Como resolve

Definindo uma vez com defineConnector(), ele renderiza os arquivos de configuração nativos que cada host realmente lê.

defineConnector({  
  server,  
  hooks,  
  plugins,  
  marketplace,  
})  

Não é uma abordagem de executar um wrapper intermediário nem de impor um formato proprietário.
A ideia é gerar os JSONs, TOMLs, arquivos de settings etc. que cada CLI já lê originalmente.

Escopo de suporte

Atualmente, além do registro de servidores MCP, ele cobre também as áreas abaixo.

• Registro de servidores MCP
• Conversão do modelo de eventos de hooks por host
• Empacotamento de plugins / extensões
• Fluxo de instalação via marketplace de cada host
• Instalação em lote para vários CLIs
• Remoção de configurações residuais com uninstall --purge
• Telemetria de tokens por ferramenta
• Criação de CLIs com marca própria baseados em SDK

O uso é mais ou menos assim.

$ agent-connector install  
$ agent-connector uninstall --purge  
# ou  
$ plugin install brand-name   

Estado atual

Até agora, estou desenvolvendo isso sozinho.

Os principais pontos em que investi tempo foram os seguintes.

• Renderização de configuração cross-host
• Normalização do modelo de eventos de hooks
• Empacotamento de plugins / extensões
• Fluxo de instalação via marketplace
• Telemetria
• Testes em Linux / macOS / Windows

Atualmente, é possível gerar configurações para 42 CLIs de agentes.

O que já validei

Em testes reais, portei o MCP existente context-mode.

O resultado foi este.

• Código de implantação por host: 20.322 linhas → 76 linhas
• Scripts de hook: 71 → 0
• CLIs compatíveis: 15 → 42

Mas este não é um servidor MCP criado por mim, e sim um caso de portar um servidor já existente.
Por isso, quero ver mais casos de quebra em servidores MCP variados.

Feedback que estou procurando

Se quem está criando servidores MCP puder subir seus próprios casos e enviar feedback, isso ajudará muito.

Em especial, gostaria de receber feedback sobre pontos como estes.

• Casos em que a configuração quebra em um CLI específico
• Casos em que o modelo de eventos de hooks é insuficiente
• Pontos estranhos no fluxo de plugins / marketplace
• Partes incômodas no design da API
• Críticas à estrutura do projeto OSS

Se o MCP é a camada que conecta ferramentas reais aos agentes, acredito que precisamos de uma estrutura que não fique refém do modo de configuração de um CLI específico.

• Demo: https://agent-connector.ai
• GitHub: https://github.com/ken-jo/agent-connector
• npm: @ken-jo/agent-connector
• License: Apache-2.0