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.

Related MCP server: mcp-seipro

📦 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)

🤖 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