mcp-eouve

Servidor Model Context Protocol (MCP) para integração com o portal eOuve (Ouvidoria Municipal & e-SIC).

Ele permite que você:

1. Autentique-se com credenciais ou com um token JWT.

2. Liste os acompanhamentos de Ouvidoria.

3. Liste as solicitações de e-SIC (Pedido de Informação).

4. Envie/Cadastre novos pedidos de e-SIC.

5. Liste os órgãos (secretarias) e assuntos cadastrados para qualquer município/cidade suportada.

Pré-requisitos

• Node.js (recomendado v20+)

• npm

Instalação

1. Clone ou copie este repositório para o seu sistema.

2. Execute o comando npm install na pasta do projeto:

   npm install

Ferramentas Expostas (Tools)

1. login

Autentica no sistema eOuve e armazena o token de acesso para a sessão ativa.

• Parâmetros:

  • username (string, obrigatório): E-mail ou CPF/CNPJ.

  • password (string, obrigatório): Senha de login.

  • cityId (string, opcional, padrão: "2355" para Olinda).

2. list_ouvidorias

Lista as manifestações ativas de Ouvidoria associadas ao usuário.

• Parâmetros:

  • token (string, opcional): Token de acesso (se omitido, utiliza o token ativo da sessão).

3. list_sics

Lista os Pedidos de Informação (e-SIC) ativos associados ao usuário.

• Parâmetros:

  • token (string, opcional): Token de acesso (se omitido, utiliza o token ativo da sessão).

4. list_secretarias

Obtém as secretarias e IDs de assuntos cadastrados para a cidade especificada.

• Parâmetros:

  • cityId (string, opcional): Padrão: cidade da sessão ou "2355".

  • token (string, opcional): Token de acesso.

5. send_sic

Envia um novo Pedido de Informação (e-SIC).

• Parâmetros:

  • pergunta (string, obrigatório): O conteúdo do pedido de informação.

  • idSecretaria (string, obrigatório): ID da secretaria de destino.

  • idSecretariaAssunto (string, obrigatório): ID do assunto específico.

  • token (string, opcional): Token de acesso.

  • idUnidade (string, opcional, padrão: "").

  • dadosSigilosos (string, opcional, padrão: "N").

  • urgente (string, opcional, padrão: "N").

Integração com o Claude Desktop

Para configurar este servidor no Claude Desktop, edite o seu arquivo de configuração:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione a configuração do servidor:

{
  "mcpServers": {
    "eouve": {
      "command": "node",
      "args": ["/caminho/absoluto/para/mcp-eouve/index.js"],
      "env": {}
    }
  }
}

Substitua /caminho/absoluto/para/mcp-eouve/index.js pelo caminho real da pasta do projeto em sua máquina.