Oracle EIM Data Quality

온프레미스 Oracle 및 Oracle ATP를 대상으로 거버넌스가 적용된 EIM 데이터 품질 검사를 수행하는 독립형 MCP 서버입니다. Oracle MCP 챗봇이 아닙니다.

챗봇 프로젝트(oracle-mcp-chatbot)는 자연어 질문에 답변합니다. 이 프로젝트는 EIM_APPS.EIM_DQ_RULES_LOOKUP에서 ACTIVE 규칙만 로드하고, 승인된 읽기 전용 집계 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

• 객체 확인에 사용되는 동일한 읽기 전용 discovery/validate/execute 도구

Cursor MCP

Cursor에서 mcp-clients/cursor-mcp.json을 지정합니다(절대 경로는 교체). 워크스페이스 .cursor/mcp.json은 cwd를 이 리포지토리로 설정한 oracle-eim-dq를 등록해야 하며, 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을 변경한 후 Cursor의 MCP 서버를 다시 로드하세요. 채팅에서 먼저 List the active EIM data-quality rules.라고 질문하세요. 해당 호출이 ACTIVE 규칙 ID를 반환할 때까지 규칙 실행을 시도하지 마세요.