apache/doris-mcp-server

해결하는 문제

AI 에이전트와 MCP(Model Context Protocol) 호스트가 Apache Doris 데이터베이스와 안전하고 읽기 전용 방식으로 상호작용할 수 있도록 합니다. LLM과 복잡한 데이터베이스 기능 사이의 격차를 메우며, 에이전트가 완전한 관리 권한을 부여받지 않고도 구조화된 방식으로 데이터베이스 작업을 탐색하고 실행할 수 있도록 합니다.

작동 방식

서버는 MCP 프로토콜을 구현하여 Apache Doris 기능을 도구 세트로 노출합니다. 에이전트는 먼저 doris_query 또는 doris_cluster와 같은 "도메인"을 호출하여 특정 하위 기능과 스키마를 탐색합니다. stdio 및 Streamable HTTP를 포함한 여러 전송 방식을 지원하며, Doris RBAC(Role-Based Access Control)가 데이터 가시성에 대한 최종 권한을 유지하는 엄격한 보안 경계를 구현합니다.

대상 사용자

Apache Doris에 저장된 데이터를 쿼리, 모니터링 또는 분석해야 하는 AI 에이전트 개발자 또는 MCP 호환 호스트를 사용하는 개발자입니다.

주요 특징

• 계층적 도구 설계: 55개의 하위 기능을 8개의 안정적인 도메인(예: catalog, query, cluster, pipeline, search, governance, lakehouse, semantic)으로 정리합니다.
• 읽기 전용 보안: 실수 또는 악의적인 데이터 수정을 방지하기 위해 내장된 읽기 전용 카탈로그를 제공합니다.
• 기업 수준 보안: JWT, OAuth/OIDC, Doris 기반 OAuth를 지원하며, 시크릿과 오류는 마스킹됩니다.
• 세부 관찰성: 클러스터 메트릭, 느린 쿼리 진단, 라이프사이클 추적을 위한 기능을 제공합니다.
• 유연한 배포: 로컬 stdio와 네트워크 기반 HTTP 전송 모두를 지원합니다.