json-repair-mcp

json-repair-mcp

Servidor MCP (Model Context Protocol) que expõe a JSON Repair & Validate API como uma ferramenta (repair_json) consumível por qualquer cliente MCP — Claude Desktop, Cursor, e qualquer outro app ou agente compatível com o protocolo.

Isso é uma segunda porta de entrada para o mesmo produto: quem já usa POST /repair direto por HTTP continua podendo; isso aqui é para quem prefere (ou cujo agente exige) descoberta via MCP.

Testado nesta sessão

• npm install — dependências reais (@modelcontextprotocol/sdk, zod).
• Conectado com um cliente MCP real (não simulado): a ferramenta repair_json aparece corretamente no listTools(), com o schema certo.
• Chamada sem JSON_REPAIR_API_KEY configurada devolve um erro claro (em vez de travar), explicando como conseguir uma chave.
• Chamada com uma chave válida (testável com a sua, se quiser) encaminha para a API já hospedada e retorna o JSON reparado.

O que fazer com estes arquivos

1. Teste localmente (opcional)

cd json-repair-mcp
npm install
JSON_REPAIR_API_KEY=sua_chave node test_client_live.mjs

2. Publique no npm (para instalação via npx)

Isso exige uma conta no npmjs.com — gratuita, só email. Se você já tem uma, pule para o npm publish.

npm login
npm publish

Depois disso, qualquer cliente MCP consegue instalar rodando npx json-repair-mcp.

3. Registre no MCP Registry oficial (opcional, mas recomendado)

O MCP Registry é o catálogo oficial mantido por Anthropic, GitHub, Microsoft e outros — é o principal lugar onde clientes MCP (e agentes) descobrem servidores novos.

A publicação usa autenticação via GitHub — a mesma conta que você já criou, sem precisar de mais nada novo:

# Instale a CLI oficial de publicação (via npx, não precisa instalar global)
npx @modelcontextprotocol/publisher login github

# Publique usando o server.json já pronto nesta pasta
npx @modelcontextprotocol/publisher publish

O server.json já está preenchido — só ajuste o campo repository.url se o nome do seu repositório no GitHub for diferente de json-repair-mcp.

Configuração de exemplo para um cliente MCP (ex: Claude Desktop)

{
  "mcpServers": {
    "json-repair": {
      "command": "npx",
      "args": ["-y", "json-repair-mcp"],
      "env": {
        "JSON_REPAIR_API_KEY": "sua_chave_aqui"
      }
    }
  }
}