Skip to content

OceanBase MCP v1.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 02 Jul 00:55
· 178 commits to main since this release
v1.1.0
58f7a6b

OceanBase MCP v1.1.0

This release adds metadata change analysis for local OceanBase development. It helps developers capture metadata snapshots, compare iteration changes, map changes to project SQL usage, and generate review reports. The server remains strictly read-only.

新增能力

  • 元数据快照：ob_capture_metadata_snapshot 和 ob-mcp metadata snapshot 采集表、字段、索引、约束、分区、关系、统计信息、注释和 Oracle 对象元数据。
  • 快照对比：ob_compare_metadata_snapshots 和 ob-mcp metadata diff 输出结构化 diff、风险等级和 Markdown 摘要。
  • SQL 使用索引：ob-mcp scan-sql --index-out 为项目 SQL 生成静态索引。
  • SQL 使用查询：ob_find_sql_usages 按表、字段或业务词查找项目 SQL 引用。
  • 影响分析：ob_analyze_metadata_impact 和 ob_analyze_change_sql_impact 汇总受影响对象、SQL、文件、关系和风险证据。
  • 变更报告：ob_generate_metadata_change_report 和 ob-mcp metadata report 输出 Markdown 或简版 HTML。
  • 关系路径：ob_explain_relationship 增加有限深度 relationship path，显示路径表、关系数、confidence 和 evidence。
  • OpenCode 工作流：Agent/Skill 增加“迭代开始快照 -> SQL index -> 迭代结束快照 -> diff -> impact -> report”的流程。

验证结果

  • 本地 OceanBase MySQL 模式：MCP smoke 通过，覆盖 metadata snapshot、snapshot diff、SQL usage index、impact analysis、change report 和只读拦截。
  • 本地 OceanBase Oracle 模式：MCP smoke 通过，覆盖 metadata snapshot、snapshot diff、Oracle object metadata、SQL usage index、impact analysis、change report 和只读拦截。
  • HTTP MySQL smoke 和 HTTP Oracle smoke 通过。
  • npm test 通过，199 个测试全部通过。
  • npm run docs:check 通过，检查 30 个 Markdown 文件。
  • npm audit --omit=dev --audit-level=moderate 通过，0 个漏洞。
  • npm pack --dry-run 通过，生成 ob-mcp-1.1.0.tgz。
  • Docker build 通过，镜像标签 oceanbase-mcp:1.1.0。
  • Release workflow 通过。

Delivery Assets

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

内网源码编译

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

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

生产注意事项

  • 建议数据库账号仍使用只读权限；MCP 会继续拦截写入、DDL、DCL、过程调用、序列 NEXTVAL、锁和危险函数。
  • 元数据变更报告只输出风险、证据和评审建议，不输出可直接执行的 DDL。
  • 大 schema 建议使用 schema、tablePattern 和 max 限制控制采集范围。
  • SQL 使用索引来自静态扫描。动态 SQL 会标记为不确定，需要人工复核。
  • OpenCode 使用前建议先加载随包提供的 Agent/Skill 配置。
Assets 7
Loading