MCP Config Generator

Uma ferramenta web para adicionar servidores MCP com segurança à sua configuração do Claude Desktop.

Documentação

Gerador de Configuração MCP

Uma ferramenta web moderna para adicionar servidores MCP com segurança à sua configuração do Claude Desktop sem quebrar a estrutura JSON.

🌟 Recursos

  • Gerenciamento Seguro de Configuração - Carregue sua configuração existente e adicione novos servidores com segurança
  • Validação JSON - Evita quebrar sua configuração com validação automática
  • Múltiplos Tipos de Servidor - Suporta configurações de servidores baseadas em comandos, HTTP e personalizadas
  • Lista Visual de Servidores - Veja todos os seus servidores atuais com opções fáceis de remoção
  • Copiar e Baixar - Exportação fácil da sua configuração final
  • Formatação em Tempo Real - Formatação e validação automática de JSON
  • Design Responsivo - Funciona em dispositivos desktop e móveis

🎯 Problema que Resolve

Quando você encontra uma nova configuração de servidor MCP online e deseja adicioná-la à sua configuração existente do Claude Desktop, editar o JSON manualmente pode ser arriscado - um erro de sintaxe quebra toda a configuração. Esta ferramenta elimina esse risco ao:

  • Validar sua configuração existente primeiro
  • Mesclar com segurança novas configurações de servidor
  • Garantir que a saída final seja JSON válido
  • Fornecer feedback visual durante todo o processo

🚀 Como Usar

1. Carregue Sua Configuração Atual

  • Abra a ferramenta no seu navegador: mcp-conf-gen.pages.dev
  • Cole o conteúdo do seu claude_desktop_config.json existente na primeira área de texto
  • Clique em "Validar Configuração" para garantir que está formatado corretamente
  • Ou use "Carregar Exemplo" para começar com uma configuração de exemplo

2. Adicione Novos Servidores

  • Encontre uma configuração de servidor em um site (GitHub, documentação, posts de blog, etc.)
  • Copie o bloco JSON do servidor (apenas a parte do servidor, não a configuração inteira)
  • Digite um nome único de servidor no campo "Nome do servidor"
  • Cole a configuração JSON no campo "Configuração JSON do servidor"
  • Clique em "Adicionar Servidor" - a ferramenta valida e adiciona com segurança

3. Gerencie Seus Servidores

  • Veja todos os servidores atuais na seção "Servidores Atuais"
  • Veja detalhes do comando e configuração de cada servidor
  • Remova servidores indesejados com o botão de excluir
  • Os detalhes do servidor são truncados para legibilidade, mas mostram informações completas ao passar o mouse

4. Exporte Sua Configuração

  • Veja a configuração completa na seção "Configuração Final"
  • Copie para a área de transferência com o botão "Copiar"
  • Baixe como arquivo com o botão "Baixar"
  • Use "Formatar" para limpar a formatação JSON

📋 Fluxo de Trabalho de Exemplo

Sua configuração existente:

{
  "serverConfig": {
    "command": "/bin/sh",
    "args": ["-c"]
  },
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": ["@wonderwhy-er/desktop-commander@latest"]
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Encontrou uma nova configuração de servidor online:

"github": {
  "type": "http",
  "url": "https://api.githubcopilot.com/mcp/",
  "headers": {
    "Authorization": "Bearer ${input:github_mcp_pat}"
  }
}

Resultado após adicionar com segurança:

{
  "serverConfig": {
    "command": "/bin/sh",
    "args": ["-c"]
  },
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": ["@wonderwhy-er/desktop-commander@latest"]
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${input:github_mcp_pat}"
      }
    }
  }
}

📁 Configuração do Claude Desktop

  1. Use a ferramenta para gerar sua configuração
  2. Copie ou baixe a configuração final
  3. Salve como claude_desktop_config.json na sua pasta de configuração do Claude:
    • macOS: ~/Library/Application Support/Claude/
    • Windows: %APPDATA%/Claude/
    • Linux: ~/.config/claude/
  4. Reinicie o Claude Desktop para carregar a nova configuração

🛠️ Tipos de Servidor Suportados

Servidores Baseados em Comandos

{
  "command": "npx",
  "args": ["@modelcontextprotocol/server-github"]
}

Servidores HTTP

{
  "type": "http",
  "url": "https://api.example.com/mcp/",
  "headers": {
    "Authorization": "Bearer ${input:api_key}"
  }
}

Configurações Personalizadas

Qualquer configuração válida de servidor MCP é suportada. A ferramenta preserva todas as propriedades e estruturas.

🔧 Desenvolvimento

O projeto usa HTML, CSS e JavaScript puros, sem dependências ou processo de build.

# Clone the repository
git clone https://github.com/maslybs/mcp-config-generator.git

# Open in browser
open index.html

Estrutura do Projeto

  • index.html - Aplicação completa em arquivo único
  • README.md - Esta documentação

🌐 Demonstração ao Vivo

Visite mcp-conf-gen.pages.dev para usar a ferramenta online.

🤝 Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

📝 Licença

Licença MIT - veja o código para detalhes.