generic-mcp-server

Servidor MCP genérico para carregar tools dinamicamente a partir da pasta tools/.

O que ele faz

• Descobre scripts de tools em tempo de inicialização
• Executa cada tool como processo isolado
• Envia os argumentos via stdin em JSON
• Expõe o resultado no protocolo MCP

Estrutura

generic-mcp-server/
├── server.js
├── loader.js
├── executor.js
├── utils.js
├── package.json
└── tools/
    └── ligga_consultar/
        └── ligga_consultar.js

Instalação

npm install

Execução

node server.js ./tools

Exemplo de tool fake

// @mcp-tool
// {
//   "name": "demo_status",
//   "description": "Retorna um status falso para testes.",
//   "params": {
//     "service": {
//       "type": "string",
//       "description": "Nome do serviço",
//       "required": true
//     }
//   }
// }

console.log(JSON.stringify({
  service: "demo",
  status: "ok",
  environment: "fake",
  timestamp: "2026-03-22T00:00:00.000Z"
}));

Exemplo de resposta fake

{
  "nome": "Cliente Demo",
  "email": "cliente.demo@example.com",
  "tipo_pessoa": "Física",
  "total_contratos": 1,
  "contratos_ativos": 1,
  "contratos_inativos": 0,
  "contratos": [
    {
      "contrato": "9999999",
      "produto": "Internet Fibra 500Mbps",
      "status": "Habilitado",
      "endereco": "Rua Fictícia, 123 - Curitiba/PR"
    }
  ]
}

Observações

• Este repositório usa dados fictícios nos exemplos do README.
• Nenhum dado real deve ser colocado aqui.
• A tool real ligga_consultar continua disponível em tools/ligga_consultar/ligga_consultar.js.