# 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

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

## Instalação

```bash
npm install
```

## Execução

```bash
node server.js ./tools
```

## Exemplo de tool fake

```js
// @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

```json
{
  "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`.