MCP Server SEI (Sistema Eletrônico de Informações)

Servidor MCP (Model Context Protocol) para integração e automação com o SEI (Sistema Eletrônico de Informações) através de autenticação direta por Usuário, Senha e Órgão (sessão web), dispensando a necessidade de tokens de API.

---

🚀 Funcionalidades

• Autenticação Automática e Parametrizada: Conecta ao SEI informando Usuário, Senha e Órgão com suporte a seleção de Unidade.
• Gerenciamento de Sessão: Mantém os cookies de sessão ativos e realiza auto-relogin se a sessão expirar.
• Controle de Processos: Lista todos os processos abertos na caixa da unidade (gerados e recebidos).
• Consulta de Processos e Árvore: Obtém os metadados do processo e toda a hierarquia de documentos/anexos.
• Leitura de Documentos: Extrai o conteúdo textual limpo e dados de assinatura eletrônica de qualquer documento/despacho/ofício.
• Pesquisa Avançada: Busca processos e documentos por número, interessado ou termos textuais.
• Gestão de Unidades: Permite alternar entre diferentes unidades do órgão às quais o usuário tem acesso.
• Registro de Andamentos: Adiciona despachos e observações no histórico do processo.

---

📦 Instalação

1. Clonar ou Acessar o Diretório

cd c:\Users\chaga\OneDrive\Documentos\mcp-sei-cbm

2. Criar Ambiente Virtual e Instalar Dependências

# Criar ambiente virtual
python -m venv .venv

# Ativar ambiente virtual
# No Windows (PowerShell):
.\.venv\Scripts\Activate.ps1
# No Linux/Mac:
# source .venv/bin/activate

# Instalar dependências
pip install -r requirements.txt

---

⚙️ Configuração (.env)

Copie o arquivo de exemplo .env.example para .env e preencha com os seus dados de acesso:

cp .env.example .env

Edite o arquivo .env:

# URL base do SEI da sua instituição
SEI_BASE_URL=https://sei.cbm.df.gov.br/sei

# Usuário e senha de acesso
SEI_USUARIO=seu_usuario_ou_cpf
SEI_SENHA=sua_senha_secreta

# Órgão de autenticação (sigla ou ID conforme a lista de seleção de login)
SEI_ORGAO=CBM

# (Opcional) Unidade padrão a ser ativada no login (ex: CBM/DTI)
SEI_UNIDADE=

# (Opcional) Configurações de rede
SEI_TIMEOUT=30
SEI_VERIFY_SSL=true

---

🛠️ Ferramentas Disponíveis (MCP Tools)

Ferramenta	Descrição	Parâmetros
sei_status	Informa status da conexão, usuário logado e unidade ativa.	-
sei_conectar	Autentica ou atualiza credenciais em tempo de execução.	base_url, usuario, senha, orgao, unidade
sei_listar_controle_processos	Lista os processos na caixa de entrada da unidade atual.	-
sei_consultar_processo	Consulta processo e retorna metadados e árvore de documentos.	numero_ou_id (ex: 00053.000123/2026-10)
sei_obter_arvore_processo	Retorna todos os documentos anexados a um processo.	id_procedimento
sei_ler_documento	Lê o texto e assinaturas de um documento específico.	id_documento, id_procedimento (opcional)
sei_pesquisar	Pesquisa processos ou documentos por palavra-chave.	termo
sei_trocar_unidade	Altera a unidade de trabalho atual no SEI.	unidade (ex: CBM/DTI)
sei_adicionar_andamento	Adiciona um andamento no histórico do processo.	id_procedimento, descricao

---

🤖 Como Configurar no Claude Desktop / Cursor / Antigravity

Adicione a seguinte configuração no seu arquivo de configuração do MCP (ex: claude_desktop_config.json ou similar):

{
  "mcpServers": {
    "sei-cbm": {
      "command": "c:\\Users\\chaga\\OneDrive\\Documentos\\mcp-sei-cbm\\.venv\\Scripts\\python.exe",
      "args": [
        "-m",
        "src.server"
      ],
      "cwd": "c:\\Users\\chaga\\OneDrive\\Documentos\\mcp-sei-cbm",
      "env": {
        "SEI_BASE_URL": "https://sei.cbm.df.gov.br/sei",
        "SEI_USUARIO": "seu_usuario",
        "SEI_SENHA": "sua_senha",
        "SEI_ORGAO": "CBM"
      }
    }
  }
}

---

🧪 Testes Automatizados

Para executar a suíte de testes de validação dos parsers e configurações:

.\.venv\Scripts\python.exe -m pytest -v