mcp-sei-cbm

{"type": "text"}# MCP Server SEI (Sistema Eletrônico de Informações)

Servidor MCP (Model Context Protocol) para integración y automatización con el SEI (Sistema Eletrônico de Informações) mediante autenticación directa por Usuario, Contraseña y Órgano (sesión web), prescindiendo de la necesidad de tokens de API.

🚀 Funcionalidades

• Autenticación Automática y Parametrizada: Conecta al SEI informando Usuario, Contraseña y Órgano con soporte para selección de Unidad.

• Gestión de Sesión: Mantiene las cookies de sesión activas y realiza auto-relogin si la sesión expira.

• Control de Procesos: Lista todos los procesos abiertos en la caja de la unidad (generados y recibidos).

• Consulta de Procesos y Árbol: Obtiene los metadatos del proceso y toda la jerarquía de documentos/adjuntos.

• Lectura de Documentos: Extrae el contenido textual limpio y datos de firma electrónica de cualquier documento/despacho/oficio.

• Búsqueda Avanzada: Busca procesos y documentos por número, interesado o términos textuales.

• Gestión de Unidades: Permite alternar entre diferentes unidades del órgano a las que el usuario tiene acceso.

• Registro de Trámites: Añade despachos y observaciones en el historial del proceso.

Related MCP server: mcp-seipro

📦 Instalación

1. Clonar o Acceder al Directorio

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

2. Crear Entorno Virtual e Instalar Dependencias

# 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

⚙️ Configuración (.env)

Copie el archivo de ejemplo .env.example a .env y rellénelo con sus datos de acceso:

cp .env.example .env

Edite el archivo .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

🛠️ Herramientas Disponibles (MCP Tools)

🤖 Cómo Configurar en Claude Desktop / Cursor / Antigravity

Añada la siguiente configuración en su archivo de configuración del MCP (ej: claude_desktop_config.json o 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"
      }
    }
  }
}

🧪 Pruebas Automatizadas

Para ejecutar la suite de pruebas de validación de los parsers y configuraciones:

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