Skip to content

OceanBase MCP v1.1.4

Choose a tag to compare

View all tags
@github-actions github-actions released this 02 Jul 07:38
· 157 commits to main since this release
v1.1.4
e4a3e09

OceanBase MCP v1.1.4

This release improves ER generation performance for OceanBase MCP. It removes duplicate metadata reads from the default foreign-key ER path and avoids large schema-level inline HTML rendering before returning export guidance. The server remains strictly read-only.

新增与修复

  • ob_generate_er_diagram 和 ob_generate_er_html 默认外键关系发现只读取外键元数据。
  • 字段、索引和约束元数据只在 ER 实体阶段加载一次，避免重复读取。
  • schema 级 ob_generate_er_html 范围过大时跳过 inline 渲染，直接返回分片导出建议。
  • 显式 table 范围仍支持本地 CLI 分片渲染。
  • README、ER 文档、部署文档和 release 文档已更新到当前版本。
  • 只读策略、profile 权限、行数限制、输出大小限制、超时、审计日志和错误脱敏保持不变。

Delivery Assets

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

内网源码编译

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

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

验证结果

  • npm test：213 个测试通过。
  • npm run docs:check、npm audit --omit=dev --audit-level=moderate、npm pack --dry-run、Docker build 通过。
  • 本地 OceanBase MySQL stdio 和 HTTP smoke test 通过。
  • 本地 OceanBase Oracle stdio 和 HTTP smoke test 通过。
  • MySQL 220 表 ER 验证通过：5 次元数据查询、1,980 个加载字段。
  • Oracle 220 表 ER 验证通过：5 次元数据查询、2,254 个加载字段。
  • ER 关系输出继续受配置上限约束，避免大范围结果失控。
  • MySQL 和 Oracle schema 级 50 表 inline HTML 请求返回导出建议。
  • MySQL 和 Oracle 百万行表 ob_describe_table 验证通过。

生产注意事项

  • 建议数据库账号仍使用只读权限；MCP 会继续拦截写入、DDL、DCL、过程调用和序列 NEXTVAL。
  • 大 schema 先运行 ob_plan_er_export，再使用 CLI 分片导出。
  • 全库 ER 不建议通过 MCP inline HTML 返回，应使用本地目录导出。
  • relationshipMode=inferred 只用于明确的小范围分析，并必须查看 confidence 和 evidence。
  • 表多或字段多时调小 --chunk-size 和 --max-columns-per-table。
  • OpenCode 使用前建议先加载随包提供的 Agent/Skill 配置。
Assets 7
Loading