Skip to content

OceanBase MCP v1.1.1

Choose a tag to compare

View all tags
@github-actions github-actions released this 02 Jul 05:03
· 164 commits to main since this release
v1.1.1
31cde6a

OceanBase MCP v1.1.1

This release improves large-schema ER stability for local OceanBase development. It adds bounded ER defaults, batched metadata loading, chunked local ER export planning, and a more usable ER HTML browser. The server remains strictly read-only.

新增能力

  • 大库 ER 默认收敛：默认使用真实 FK/约束关系，命名推断需显式开启。
  • 批量元数据加载：ER 生成批量读取 columns、indexes、constraints 和关系，减少逐表查询放大。
  • ob_plan_er_export：为大 schema 返回分片导出计划、chunk 命令、stats 和 warnings，不返回超大 inline HTML。
  • CLI 分片导出：ob-mcp export-er --out-dir 写出 index.html、overview.html、chunks/、tables/ 和 metadata/。
  • ER HTML 浏览器：大图使用多列概览布局、关键字段优先、表筛选计数、schema 概览和选中表定位。
  • ER HTML 可读性：warnings 区域限制高度并可滚动，避免大库警告把主图挤出首屏。
  • 分片统计：目录导出区分实际渲染关系数和规划阶段关系上限。
  • OpenCode 工作流：大库先规划，再分片；默认 relationshipMode=foreign_key，不直接请求全库 inline ER。

Delivery Assets

  • ob-mcp-1.1.1-source.tar.gz：源码归档，用于内网编译。
  • ob-mcp-1.1.1.tgz：npm package。
  • sbom.cdx.json：CycloneDX SBOM。
  • oceanbase-mcp-1.1.1-amd64.tar.gz：amd64 离线镜像。
  • oceanbase-mcp-1.1.1-arm64.tar.gz：arm64 离线镜像。
  • ghcr.io/sevoniva/oceanbase-mcp:v1.1.1
  • ghcr.io/sevoniva/oceanbase-mcp:1.1.1

内网源码编译

tar -xzf ob-mcp-1.1.1-source.tar.gz
cd ob-mcp-1.1.1
npm ci
npm run build
npm run start

源码归档不包含 node_modules 和 dist。内网 npm 制品库需要能提供 package-lock.json 中锁定的依赖。

验证要求

  • OceanBase MySQL 模式 smoke test 覆盖 ER plan、默认 FK 关系、HTML 降级和分片导出。
  • OceanBase Oracle 模式 smoke test 覆盖 ER plan、默认 FK 关系、HTML 降级和分片导出。
  • 本地 MySQL 220 表和 Oracle 220 张复杂测试表大 schema 验证通过。
  • npm test、npm run docs:check、npm audit --omit=dev --audit-level=moderate、npm pack --dry-run、Docker build 通过。

生产注意事项

  • 建议数据库账号仍使用只读权限；MCP 会继续拦截写入、DDL、DCL、过程调用和序列 NEXTVAL。
  • 大 schema 先使用 ob_plan_er_export，再用 CLI 分片导出。
  • relationshipMode=inferred 只用于明确的小范围关系推断，必须查看 confidence 和 evidence。
  • 大图单个 chunk 仍受 OB_MAX_RESULT_BYTES 控制；必要时调小 --chunk-size。
  • OpenCode 使用前建议先加载随包提供的 Agent/Skill 配置。
Assets 7
Loading