OceanBase on K8s 遇上 AI——okctl-mcp-server设计详解
<p>作者：李子毅，目前就读于武汉大学研究生二年级，OceanBase 社区贡献者、SIG 成员。对AI、向量数据库、云原生等领域感兴趣并积极探索。</p><h2 id="前情提要"><strong>前情提要</strong></h2>
<h3 id="什么是okctl"><strong>什么是okctl</strong></h3>
<p>okctl是与ob-operator配套的命令行管理工具，全名为OceanBase Kubernetes Control Tool， 它诞生于2024年的开源之夏项目，可以实现集群管理、租户资源管理、备份策略资源管理、组件管理等多项功能，同时，它还可以提供本地组件的版本检查及更新，以及建议搭建集群和配套租户的命令，适用于ob on k8s的资源管控。</p>
<h3 id="为什么需要okctl-mcp-server"><strong>为什么需要okctl-mcp-server</strong></h3>
<p>MCP（Model Context Protocol）协议由Anthropic提出，旨在为AI与其他数据源之间提供一种统一、标准且安全的数据连接方式，使AI可以集成文件系统、数据库，以及各种现有系统。MCP协议可以作为大模型的“手和脚”，提升大模型的能力。</p>
<p>2025年被称为Agent元年，MCP协议的出现也使各家公司纷纷提出自己的MCP服务器，包括各个数据库厂商。因此，我有想法去实现okctl的mcp-server，作为一次AI在运维工作上的尝试。</p>
<p>言归正传，为什么需要okctl-mcp-server？在AI时代，随着各种AI IDE的出现，编码的门槛和成本逐渐降低，开发一个项目的速度越来越快，因此，在开发一个项目前，了解自己的目的，技术选型、以及系统架构显得更为重要。</p>
<p>对于目前OceanBase在K8s上的运维，主要有三种方式：</p>
<ul>
<li>传统的采用yaml的方式抛出资源与K8s进行交互；</li>
<li>采用OB-Dashboard（配套管理界面服务）在页面上进行操作；</li>
<li>采用okctl命令行工具组合命令实现运维。</li>
</ul>
<p>这三种方式各有利弊，首先，采用yaml的方式抛出资源与K8s进行交互，适合于对K8s的基础操作，以及OceanBase的各种资源配置有深刻理解的用户；其次，</p>
<p>OB-Dashboard则作为ob-operator上的管理工具，可以采用页面的方式进行配置，非常适合对于一些精细配置的调控，也适合采用ob-operator的企业运维人员对集群进行管理；最后，是okctl，okctl设计的初衷是为了简化kubectl的使用，同时，也扩展相关的功能，如组件安装、简易集群搭建。</p>
<p>但随着后续的使用，我们发现，对于okctl而言，一些常见的命令和一些简单的配置，在日常中使用的频率是较高的。而对于一些较为精细的配置，例如完成对集群的zone资源的一些调控，则需要非常复杂的命令参数组合。同时也需要用户去阅读okctl的help命令所对应的相关文档，这很明显是对用户不友好的，也是该工具的不足之处。</p>
<p>那么，能否有一种方式，使较为复杂的配置可以简单的完成？显然，MCP协议可以实现这一设想，因此我们的设想是，通过okctl-mcp-server的配置，使较为复杂的资源运维操作可以用自然语言进行描述，并交由AI来完成。而okctl作为功能提供的底座，可以通过最少量的代码来为AI提供调用的能力，并且，也可以和其他mcp server进行集成，使AI可以实现更加复杂的工作流。</p>
<p>另外，由于我在OceanBase Cloud Native这个SIG总参与共建一年多，得到了社区的很多帮助，也希望为社区贡献自己的力量，多做一些尝试。</p>
<p>下面，我将讲解一下具体的设计思路。</p>
<h2 id="设计思路"><strong>设计思路</strong></h2>
<h3 id="模块分析"><strong>模块分析</strong></h3>
<p>主要的模块如下图所示：</p>
<p><img src="https://intranetproxy.alipay.com/skylark/lark/0/2025/png/32756313/1752824812463-d5a97747-c65a-40e3-a093-9e92578904ed.png"></p>
<p>其中，部分功能需要对齐okctl的实现，也就是底层调用okctl的命令，较为简单。部分功能则为后续编写，为了给AI提供更多的集群检测能力而设计。 目前代码已经合并到mcp-oceanbase仓库中，具体的实现细节可以参考该仓库：https://github.com/oceanbase/mcp-oceanbase</p>
<h3 id="示例场景"><strong>示例场景</strong></h3>
<p>创建集群并查看状态：</p>
<p><img src="https://intranetproxy.alipay.com/skylark/lark/0/2025/png/32756313/1752824812485-a64adc67-31e8-48ce-a290-0fdae79df808.png"></p>
<p>连接到集群下指定租户并执行SQL语句：</p>
<p><img src="https://intranetproxy.alipay.com/skylark/lark/0/2025/png/32756313/1752824812472-75613242-7c4f-4890-83de-ee1426de137a.png"></p>
<p>修改租户密码，创建空备租户并实现主备租户切换：</p>
<p><img src="https://intranetproxy.alipay.com/skylark/lark/0/2025/png/32756313/1752824812477-9e2a9af2-a251-4285-a895-01f7a3d49ed9.png"></p>
<p><img src="https://intranetproxy.alipay.com/skylark/lark/0/2025/png/32756313/1752824812491-fe598f85-5d7d-41e1-80ea-acb91feeb4ba.png"></p>
<p>对于该操作，可以看到当租户密码修改未完成时，可以等待租户的操作完成，并再次尝试。</p>
<p>通过这三个简单的操作，可以看到，通过自然语言的交互，原本复杂的运维操作变得非常简单。</p>
<h3 id="其他优化"><strong>其他优化</strong></h3>
<p>对于该项目，我们又进行了一些其他优化，用于为用户提供更好的使用体验。</p>
<p>首先，经过调研我们发现，对部分mcp client而言，装载的mcp server过多时，会出现问题，而okctl-mcp-server一个工具就提供了30多个tools，这是非常不利的，因此需要为用户提供动态加载的能力，从而实现灵活的配置，来避免tools过多时加载过慢的问题，只需要在启动时，在命令行添加对应的参数，选择要启动的模块即可。</p>
<p>其次，我们也做了对长任务的优化，对于每一个任务，处理的流程都是先调用相关工具，获得状态信息，并交由LLM进行处理。而对于部分操作如创建集群、更改集群，需要消耗大量的时间，短时间内的调用，返回的集群状态显然是不符合预期的。LLM会反复调用tool中的show cluster和show tenant函数去检查状态，而这样不断的调用，最大的问题就是会消耗大量token，而这些显然也是无意义的。</p>
<p>为了解决该问题，我们想出的简单的解决办法就是当执行集群资源的创建更改等操作时，采用轮询的方式进行检测，直到集群的状态为running，再返回给LLM。这样可以避免无意义的token消耗，但弊端是这两个操作的响应时间变长了。</p>
<h2 id="存在的问题"><strong>存在的问题</strong></h2>
<p>在介绍了上述优点之后，让我们来探讨一下不足。</p>
<p>目前，该工具有一定的局限性，首先体现在，运维操作相对于其他操作的成本较高。而LLM是概率模型，工具的调用，很大程度上依赖于AI的判断，甚至可以说依赖于LLM本身，以及prompt的编写。因此即便能通过学习和优化prompt的编写，仍然无法完全将运维的操作交由AI来执行，只能作为辅助。</p>
<h2 id="写在最后"><strong>写在最后</strong></h2>
<p>该项目还在继续更新迭代中，连接集群功能正在进行重构，后续会在okctl中实现该功能。</p>
<p>希望未来随着LLM的不断发展和新技术、新的交互协议的迭代，我们可以得到更好的解决方案，并在AI运维的道路上进行更多探索。</p>
<p>最后，希望OceanBase社区和Cloud Native SIG越来越好！ 如果你也对该项目感兴趣，请多多关注ob-operator和mcp-oceanbase仓库：https://github.com/oceanbase/mcp-oceanbase</p>
<blockquote>
<p>最后为大家推荐这个 OceanBase 开源负责人老纪的公众号「老纪的技术唠嗑局」，会持续更新和 #<strong>数据库</strong>、# <strong>AI</strong>、#<strong>技术架构</strong> 相关的各种技术内容。欢迎感兴趣的朋友们关注！<br>
「老纪的技术唠嗑局」不仅希望能持续给大家带来有价值的技术分享，也希望能和大家一起为开源社区贡献一份力量。如果你对 OceanBase 开源社区认可，点亮一颗小星星 ✨ 吧！你的每一个Star，都是我们努力的动力。</p>
<p>https://github.com/oceanbase/oceanbase</p>
</blockquote><br><br>
来源：https://www.cnblogs.com/OBCE666/p/18991652
頁:
[1]