MCP-сервер SEI (Sistema Eletrônico de Informações)

Сервер MCP (Model Context Protocol) для интеграции и автоматизации с SEI (Sistema Eletrônico de Informações) через прямую аутентификацию по Пользователю, Паролю и Органу (веб-сессия), без необходимости использования токенов API.

🚀 Возможности

• Автоматическая и параметризованная аутентификация: Подключение к SEI с указанием Пользователя, Пароля и Органа с поддержкой выбора Подразделения.

• Управление сессией: Поддержание активных cookies сессии и автоматический повторный вход при истечении сессии.

• Управление процессами: Список всех открытых процессов в ящике подразделения (созданных и полученных).

• Просмотр процессов и дерева документов: Получение метаданных процесса и всей иерархии документов/вложений.

• Чтение документов: Извлечение очищенного текстового содержимого и данных электронной подписи любого документа/распоряжения/служебной записки.

• Расширенный поиск: Поиск процессов и документов по номеру, заинтересованному лицу или ключевым словам.

• Управление подразделениями: Переключение между различными подразделениями органа, к которым у пользователя есть доступ.

• Регистрация движений по делу: Добавление распоряжений и примечаний в историю процесса.

Related MCP server: mcp-seipro

📦 Установка

1. Клонирование или переход в каталог

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

2. Создание виртуального окружения и установка зависимостей

# 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

⚙️ Настройка (.env)

Скопируйте файл-образец .env.example в .env и заполните свои данные для входа:

cp .env.example .env

Отредактируйте файл .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

🛠️ Доступные инструменты (MCP Tools)

🤖 Как настроить в Claude Desktop / Cursor / Antigravity

Добавьте следующую конфигурацию в файл настроек MCP (напр.: claude_desktop_config.json или аналогичный):

{
  "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"
      }
    }
  }
}

🧪 Автоматические тесты

Для запуска набора тестов проверки парсеров и конфигураций:

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