介绍 YugabyteDB MCP Server

介绍 YugabyteDB MCP ServerSfurti SarahJune 10, 2025概述YugabyteDB MCP Server是一个全新的、轻量级的、基于 Python 的服务器它允许像 Anthropic’s Claude 这样的大语言模型Large Language Model, LLM直接与你的 YugabyteDB 进行交互。在本文中我们将通过一个快速演示向你展示 MCP 如何让 AI 应用仅使用自然语言提示词prompt就能访问、查询、分析和解读 YugabyteDB 数据库中的数据。什么是 MCPModel Context Protocol (MCP) 是一项新标准它使大语言模型LLM能够以一致且标准化的方式与现有的企业服务进行交互。这些服务可以是数据提供者如 YugabyteDB 或文件服务器、执行器如邮件服务器或两者兼有。深入探讨超出了本文的范围但这个高层概述有助于说明为什么 MCP 是如此有价值的进展。当前 AI 应用面临的一个挑战是它们的有效性仅限于其训练数据并且只能通过生成文本、音频或视频来产生结果。然而如果 LLM作为 AI 应用的一部分需要访问更实时的数据或公司特定的数据该怎么办如果 AI 应用需要发送邮件、在日历中安排事件或采取其他行动又该怎么办简而言之AI 应用如何访问现有的服务在过去每个 LLM 和框架例如 LangChain都有自己的实现方式。这种缺乏标准、一致的服务接口的方式为 AI 应用开发带来了复杂性并减缓了进展。MCP 通过标准化 AI 应用使用现有服务的方式直接解决了这个问题。它的工作原理如下现有服务被封装或由MCP Server 进行代理你的应用“Host”集成了 MCP Client你的应用的 MCP Client 被配置为连接一个或多个MCP ServerClient 会发现 MCP Server 所发布的可用工具tools。工具类似于 API 端点代表 MCP Server及其后端服务提供的离散功能这些工具也以结构化的方式进行描述以便 LLM 能够详细理解所发布的功能也就是说让 LLM 知道每个函数能做什么以及如何调用它MCP Server 可以是本地的通过标准输入/输出进行通信或远程的通过网络使用 SSE 进行通信每个工具就像一个带有参数和可选返回值的函数MCP 使工具增强型 LLM 具备可扩展性、一致性和可组合性。为什么选择 YugabyteDB MCP ServerYugabyteDB 是一个开源的、兼容 PostgreSQL 的分布式 SQL 数据库专为云原生、多区域工作负载而设计。但在此之前还没有针对它的 MCP 集成。这意味着 LLM 无法直接理解或分析存储在 YugabyteDB 中的数据。因此我们构建了 MCP Server 来在 YugabyteDB 上实现LLM 驱动的数据探索使用安全的只读查询以避免修改生产数据开箱即用地支持 Claude Desktop、Cursor 和 Windsurf 等工具帮助使用自然语言与实时数据进行交互演示用 Claude 与你的 YugabyteDB 数据库对话在这个演示中我们预加载了一个运行着Northwind 数据集的三节点 YugabyteDB 集群。这为我们提供了一组丰富的示例业务数据订单、产品、客户等用于查询和可视化。我们将使用 MCP 协议将 Claude 连接到此数据库然后使用自然语言提示词进行探索。环境要求要跟随本演示你需要一个正在运行的 YugabyteDB 实例本地或远程Python 3.10uv 用于依赖管理Claude Desktop在此下载设置 YugabyteDB MCP Server克隆仓库并安装依赖gitclone https://github.com/yugabyte/yugabytedb-mcp-server.gitcdyugabytedb-mcp-server uvsync将 Claude 连接到 Server在Claude Desktop中进入Settings → Developer → Edit Config在 claude_config.json 中添加一个新的 mcpServer 条目{mcpServers:{yugabytedb-mcp:{command:uv,args:[--directory,/path/to/cloned/yugabytedb-mcp-server/,run,src/server.py],env:{YUGABYTEDB_URL:dbnamenorthwind hostlocalhost port5433 useryugabyte passwordyugabyte load_balancetrue}}}}重启 Claude 以应用更改。在以下位置查看日志macOS~/Library/Logs/ClaudeWindows%APPDATA%\Claude\Logs提示词 1总结数据库提示词“Summarize the database you are connected to.”Claude 将会调用summarize_database列出所有表及其 schema 和行数用通俗易懂的英语描述它所看到的内容示例输出提示词 2构建仪表板提示词Build a dashboard with 3 visualizations:Monthly sales trendTop 10 customers by revenueSales grouped by customer countryClaude 将会执行安全的只读 SQL 查询聚合和结构化结果为此创建一个交互式仪表板示例输出所有这些都不需要编写任何 SQL结论YugabyteDB MCP Server 弥合了你的 AI 应用及其 LLM与 YugabyteDB 数据之间的鸿沟——实现了对实时、结构化数据集的无缝自然语言交互。通过利用 Model Context Protocol我们标准化了工具集成并为直观的数据探索打开了大门无需编写任何一行 SQL。无论你是在构建仪表板、总结数据还是试验 AI 驱动的工作流这个轻量级的 MCP Server 都为 LLM 增强型应用提供了一个安全、可扩展的基础。我们很期待看到开发者们如何利用它在 YugabyteDB 之上解锁新的洞察并构建智能数据体验。要开始使用请尝试本演示探索 GitHub 仓库并告诉我们你构建了什么了解更多关于使用 YugabyteDB 构建和部署GenAI 和 RAG 应用的信息请查看这里。请持续关注我们的博客获取更多最佳实践以及 YugabyteDB MCP Server 的使用指南。