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

MCP (Model Context Protocol) server for integration and automation with SEI (Sistema Eletrônico de Informações) through direct authentication by User, Password, and Organization (web session), eliminating the need for API tokens.

🚀 Features

• Automatic and Parameterized Authentication: Connects to SEI by providing User, Password, and Organization, with support for Unit selection.

• Session Management: Keeps session cookies active and performs auto re-login if the session expires.

• Process Control: Lists all open processes in the unit's inbox (generated and received).

• Process and Tree Query: Retrieves process metadata and the entire hierarchy of documents/attachments.

• Document Reading: Extracts clean textual content and electronic signature data from any document/dispatch/letter.

• Advanced Search: Searches processes and documents by number, interested party, or textual terms.

• Unit Management: Allows switching between different units of the organization to which the user has access.

• Progress Entries: Adds dispatches and observations to the process history.

Related MCP server: mcp-seipro

📦 Installation

1. Clone or Access the Directory

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

2. Create Virtual Environment and Install Dependencies

# 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

⚙️ Configuration (.env)

Copy the example file .env.example to .env and fill it with your access credentials:

cp .env.example .env

Edit the .env file:

# 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

🛠️ Available Tools (MCP Tools)

🤖 How to Configure in Claude Desktop / Cursor / Antigravity

Add the following configuration to your MCP configuration file (e.g., claude_desktop_config.json or 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"
      }
    }
  }
}

🧪 Automated Tests

To run the validation test suite for parsers and configurations:

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