How do I use Generic MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Generic MCP Server check the status of the demo service" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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.