Oracle EIM Data Quality

Автономный MCP-сервер для управляемых проверок качества данных EIM в локальном (On-Prem) Oracle и Oracle ATP. Это не чат-бот Oracle MCP.

Проект чат-бота (oracle-mcp-chatbot) отвечает на вопросы на естественном языке. Этот проект загружает только правила со статусом ACTIVE из EIM_APPS.EIM_DQ_RULES_LOOKUP, выполняет одобренные агрегирующие SQL-запросы в режиме только чтения и возвращает готовый для руководителя отчёт в Markdown.

pip install --target .pydeps -r requirements-dev.txt
PYTHONPATH=.pydeps:src pytest
cp .env.example .env                          # add credentials
PYTHONPATH=.pydeps:src python -m oracle_mcp.server --profile both --check
PYTHONPATH=.pydeps:src python -m oracle_mcp.server --profile both

Рабочий процесс правил и контракт отчёта: docs/data-quality-framework.md.

Что делает

Related MCP server: database-mcp

MCP-инструменты

• list_active_dq_rules

• execute_data_quality_rule

• плюс те же инструменты только для чтения (обнаружение/проверка/выполнение), используемые для подтверждения объектов

Cursor MCP

Укажите Cursor на mcp-clients/cursor-mcp.json (замените абсолютные пути). Файл .cursor/mcp.json в рабочей области должен регистрировать oracle-eim-dq с cwd, указывающим на этот репозиторий, а не на oracle-mcp-chatbot.

Локальное тестирование

Выполните в этом репозитории следующие команды:

# 1. Unit and security tests (no database required)
PYTHONPATH=.pydeps:src .pydeps/bin/pytest -q

# 2. Verify both Oracle connections
PYTHONPATH=.pydeps:src python3 -m oracle_mcp.server --profile both --check

# 3. Verify the MCP tool surface and read the live ACTIVE-rule catalog
PYTHONPATH=.pydeps:src python3 scripts/verify_dq.py

Ожидаемый результат проверки:

{
  "status": "OK",
  "server": "oracle-eim-dq",
  "databases": ["ATP", "ONPREM"],
  "dq_tools": ["execute_data_quality_rule", "list_active_dq_rules"]
}

Если active_rule_count равен 0, подключение и MCP работают, но в управляемом каталоге ещё нет правил со статусом ACTIVE. Заполните и утвердите строки каталога вне этого приложения только для чтения, затем снова запустите проверку.

После изменения .cursor/mcp.json перезагрузите MCP-серверы Cursor. В чате сначала спросите: List the active EIM data-quality rules. Не пытайтесь выполнить правило, пока этот вызов не вернёт идентификатор правила со статусом ACTIVE.