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.