MCP 서버

개요

저장소에는 Model Context Protocol 네이티브 stdio 서버인 mcp_server.py가 포함되어 있습니다. 이 공개 API 위의 얇은 프런트엔드로, 실행 중인 서버와 HTTP로 통신하므로 AI 어시스턴트가 원시 HTTP 대신 구조화된 도구 호출로 DSA 투명성 데이터를 탐색할 수 있습니다. SQL은 절대 노출되지 않으며, 모든 쿼리는 API의 나머지 부분과 동일한 검증된 쿼리 계층을 거칩니다.

도구

• list_tables
  DSA 보고서 테이블과 데이터셋 기간을 나열합니다.
• describe_table
  테이블의 조회 가능한 차원과 측정값을 표시합니다.
• dataset_overview
  전체 데이터셋의 주요 집계값.
• run_query
  구조화된(단일 테이블 또는 복합) 쿼리를 실행하고 JSON 행을 반환합니다.
• ask
  자연어로 질문하면 LLM이 검증된 구조화 쿼리로 변환합니다.
• register
  이름과 이메일로 데모 API 키를 발급합니다 — 아래의 인증 도구를 사용할 수 있게 됩니다.
• submit_query
  전체 비동기 쿼리 작업(행 수 제한 없음, CSV 내보내기, 복합 쿼리)을 제출하고 작업 id를 반환합니다.
• poll_job
  제출한 작업이 완료될 때까지 폴링하고 그 결과를 반환합니다.

submit_query, poll_job, ask에는 API 키가 필요합니다. register는 데모 키를 발급합니다.

연결하기

서버를 MCP 호스트(예: Claude Desktop의 claude_desktop_config.json)에 추가하세요. 전체 설정은 docs/MCP.md를, 바로 사용할 수 있는 예시는 저장소의 mcp-config.example.json을 참조하세요.

{
  "mcpServers": {
    "transparency-report-api": {
      "command": "/absolute/path/to/transparency-report-api/.venv-mcp/bin/python",
      "args": ["/absolute/path/to/transparency-report-api/mcp_server.py"],
      "env": {
        "TRANSPARENCY_API_URL": "https://your-deployment.example",
        "TRANSPARENCY_API_KEY": "momo"
      }
    }
  }
}

TRANSPARENCY_API_URL, TRANSPARENCY_API_KEY, TRANSPARENCY_API_TIMEOUT로 구성합니다. 의존성(mcp + httpx)은 앱 이미지와 분리되어 requirements-mcp.txt에 있습니다. 키가 필요하신가요? API 키 받기 →