手把手教你构建基于魔搭 x OceanBase MCP 的 Agent

01 前言

AI 正当时，数据库管理是否仍需依赖复杂的 SQL 语句与命令行操作？
OceanBase 联合 ModelScope 推出“AI 驱动的数据库智能管理”新范式—— 通过 #MCP（Model Calling Protocol）技术，我们让开发者与数据库之间的交互从“敲命令”升级为“对话”。
无需记忆指令、无需编写脚本，只需用自然语言提问，即可完成 OceanBase 数据库集群的创建、运行、管理、诊断与数据分析。
本项目基于 ModelScope 创空间平台构建，融合大语言模型（LLM）与数据库工具链，实现真正意义上的“对话即操作”。无论你是数据库新手，还是资深 DBA，都能从中获得前所未有的高效体验。
02 功能介绍

MCP 服务器

本项目目前已支持 OBShell、OBServer、obdiag，分别对应数据库集群的创建，运行，管理三个阶段。在上述三个工具的支持下，用户能在不敲一行代码，不输一句指令的情况下，仅靠与 Agent 对话，完成 OceanBase 数据库集群的全生命周期使用。

所有的 MCP 服务以及更多的拓展都可以在开源仓库找到。欢迎探索～
https://github.com/oceanbase/mcp-oceanbase
OBShell MCP 介绍

OBShell 能显著的提高数据库管理效率，涵盖了集群管理、租户管理、备份与恢复、权限管理、监控与维护等多个方面。OBShell 目前支持六个工具调用：

• create_cluster：创建一个新的 OceanBase 集群。用户既可以采用默认配置迅捷部署，也可以详细指定集群参数部署自定义集群。
  
• create_tenant：创建一个新的 OceanBase 租户。一个 OceanBase 集群可以包含多个租户，一个 OceanBase 租户可以包含多个数据库用户。用户既可以采用默认配置快速创建租户，也可以详细指定租户各项参数自定义部署。
  
• get_all_obshell_sdk_methods：获取 OBShell 支持的所有方法。是在 create_cluster 和 create_tenant 的基础上增加的更多调用支持。
  
• get_obshell_sdk_methods_description：通过方法名获取 OBShell 的 sdk 方法的描述。
  
• call_obshell_sdk：调用 OBShell 的 sdk 方法。
  

OBServer MCP 介绍

通过 OBServer MCP，Agent 可以实现对数据库数据的增删查改。

• execute_sql：执行一条SQL语句。包括但不限于查询，获得表 Schema，为表添加索引等。
  

OBDiag MCP 介绍

通过 OBDiag, 用户可以实现对数据库集群的巡检，诊断，信息查询等。

• obdiag_check_run：巡检集群，并返回巡检报告。
  
• obdiag_analyze_log：分析集群日志，找出发生过的错误信息并返回。
  
• obdiag_display_list：obdiag 集群信息查询功能功能，返回支持的指令列表。
  
• obdiag_display_run：obdiag 集群信息查询功能，执行获取的指令列表，需要功能来自 obdiag_display_list 的返回结果。
  

Agent 实现逻辑

通过 mcp_cluster 管理 OceanBase MCP 服务器的元数据并对 MCP 服务器进行管理。AI 推理时会新建一个异步进程进行推理，推理过程的工具调用 mcp_cluster 进行，推理得到的结果通过进程通信（一个队列）返回到主进程，从而打印到魔搭 web 页面。
03 基于魔搭创空间体验属于自己的 AI Workshop

要求：

• 尽量不要使用 Safari 浏览器，以免上传不了导数数据集。
  
• 提前注册好魔搭账户。如果要使用魔搭的免费 API，请绑定好阿里云的账户。
  

注：如果误操作造成了环境异常，请根据3.7附录：环境修复中的操作重启即可。
3.1 复制AI Workshop 创空间

进入 OceanBase 的官方创空间，复制一个自己的创空间。
https://modelscope.cn/studios/OceanBase/Oceanbase-AI_Workshop-Public/summary

创空间配置：

我们主要有三项配置需要关注：

• “英文名称”：改成一个自己喜欢的名称。
  
• “是否公开”：选择“非公开”。避免外来用户滥用私有创空间的API_KEY额度。
  
• 环境变量配置：API_KEY：可以使用魔搭提供的免费API_KEY。获取步骤：绑定好阿里云的账号：
  

打开https://modelscope.cn/my/myaccesstoken即可查看自己的API_KEY（即访问令牌）。

• LLM_MODEL：模型名称。演示使用的是
  

Qwen/Qwen3-235B-A22B-Instruct-2507

• LLM_BASE_URL：模型API调用的URL。如果使用的是魔搭的API_KEY，则填写：
  https://api-inference.modelscope.cn/v1/
  

1. API_KEY = {API_KEY} # 注册魔搭账号免费获取大额度 API_KEY
2. LLM_MODEL = Qwen/Qwen3-235B-A22B-Instruct-2507
3. LLM_BASE_URL = https://api-inference.modelscope.cn/v1/

复制代码

• 其他配置项采用初始默认项即可。
  

填写好配置后，点击复制创空间按钮得到属于自己的一个创空间。之后等待创空间初始化完毕即可。第一次使用创空间初始化时间比较长，请耐心等待。
3.2 部署数据库集群

创建 OceanBase 集群：

1. 调用工具，采用默认配置创建一个 OceanBase 数据库集群

复制代码

创建 OcenBase 租户：

1. 调用工具，采用默认配置创建一个 OceanBase 数据库租户

复制代码

3.3 创建导数目标表


测试数据：
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

很好很强大  我过来先占个楼 待编辑

感谢发布原创作品，程序园因你更精彩

收藏一下   不知道什么时候能用到

用心讨论，共获提升！

分享、互助 让互联网精神温暖你我