apache/doris-mcp-server

解决的问题

允许 AI 代理和 MCP（模型上下文协议）主机以安全、只读的方式与 Apache Doris 数据库进行交互。通过为代理提供一种结构化的方式来发现和执行数据库操作，弥合了 LLM 与复杂数据库功能之间的差距，同时不授予其完整的管理访问权限。

工作原理

该服务器实现 MCP 协议，将 Apache Doris 功能作为一组工具暴露出来。它采用分层发现机制，代理首先调用一个“域”（如 doris_query 或 doris_cluster）来发现特定的子功能及其模式。支持多种传输方式，包括 stdio 和 Streamable HTTP，并强制执行严格的安全部署边界，其中 Doris RBAC（基于角色的访问控制）是数据可见性的最终权威。

适用人群

需要查询、监控或分析存储在 Apache Doris 中的数据的 AI 代理开发者，或使用 MCP 兼容主机的开发者。

主要亮点

• 分层工具设计：将 55 个子功能组织为 8 个稳定的域（例如 catalog、query、cluster、pipeline、search、governance、lakehouse 和 semantic）。
• 只读安全：内置只读目录，防止意外或恶意的数据修改。
• 企业级安全：支持 JWT、OAuth/OIDC 以及基于 Doris 的 OAuth，敏感信息和错误信息均被脱敏处理。
• 详细可观测性：提供集群指标、慢查询诊断和数据血缘追踪等功能。
• 灵活部署：支持本地 stdio 和基于网络的 HTTP 传输。