Skip to content

Releases: sevoniva-labs/oceanbase-mcp

Release list

OceanBase MCP v1.5.0

OceanBase MCP v1.5.0 Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 03 Jul 12:41
v1.5.0
dd2d577

OceanBase MCP v1.5.0

v1.5.0 refreshes the public documentation and release wording. It does not change the database read-only boundary or add write, DDL, DCL, procedure execution, or sequence NEXTVAL capability.

Changes

  • Reworked the root README into a concise public entry point.
  • Split the complete MCP tool list into dedicated English and Chinese tool documents.
  • Kept the tool list sorted by first supported version.
  • Updated installation, OpenCode, source-build, release-asset, and deployment wording for public distribution.
  • Replaced internal-facing distribution wording with neutral npm registry mirror wording.
  • Added documentation checks for public wording and tool-table order.
  • Updated package, server, Docker Compose, Kubernetes, README, OpenCode, and deployment examples to v1.5.0.

Distribution

npm install -g @sevoniva/oceanbase-mcp@1.5.0
ob-mcp --help
npx --registry=https://registry.npmjs.org/ --yes --package=@sevoniva/oceanbase-mcp@1.5.0 ob-mcp --help

Release Assets

  • sevoniva-oceanbase-mcp-1.5.0.tgz
  • oceanbase-mcp-1.5.0-source.tar.gz
  • sbom.cdx.json
  • oceanbase-mcp-1.5.0-amd64.tar.gz
  • oceanbase-mcp-1.5.0-arm64.tar.gz
  • ghcr.io/sevoniva/oceanbase-mcp:v1.5.0
  • ghcr.io/sevoniva/oceanbase-mcp:1.5.0

Source Build

tar -xzf oceanbase-mcp-1.5.0-source.tar.gz
cd oceanbase-mcp-1.5.0
npm ci
npm run build
npm run start

The source archive excludes node_modules and dist. Your npm registry mirror must provide the dependencies locked by package-lock.json.

Validation

  • npm test: passed.
  • npm run docs:check: passed.
  • npm audit --omit=dev --audit-level=moderate: passed.
  • npm pack --dry-run: passed for sevoniva-oceanbase-mcp-1.5.0.tgz.
  • Docker build: passed for oceanbase-mcp:1.5.0.
  • npmjs install and npx --package=@sevoniva/oceanbase-mcp@1.5.0 ob-mcp --help: verified after publish.

Production Notes

  • Use a SELECT-only database account where possible; the MCP layer still enforces read-only behavior if the configured account has broader grants.
  • Keep HTTP mode behind bearer-token authentication, Host allowlists, source IP allowlists, and TLS or a trusted reverse proxy.
  • For large schemas, run ob_plan_er_export first and use CLI cluster export instead of inline ER HTML.
  • Review inferred ER relationships with their confidence and evidence.

OceanBase MCP v1.5.0

v1.5.0 重整公开文档和发布文案。本版本不改变数据库只读边界，也不增加写入、DDL、DCL、过程执行或序列 NEXTVAL 能力。

变更

  • 将根 README 重整为简洁的公开入口。
  • 将完整 MCP 工具列表拆分为独立的中英文工具文档。
  • 工具列表继续按首次支持版本排序。
  • 更新安装、OpenCode、源码构建、Release 资产和部署说明。
  • 将偏内部场景的分发措辞替换为中性的 npm registry 镜像表述。
  • 增加公开文档措辞和工具表排序检查。
  • package、server、Docker Compose、Kubernetes、README、OpenCode 和部署示例更新到 v1.5.0。

分发

npm install -g @sevoniva/oceanbase-mcp@1.5.0
ob-mcp --help
npx --registry=https://registry.npmjs.org/ --yes --package=@sevoniva/oceanbase-mcp@1.5.0 ob-mcp --help

Release 资产

  • sevoniva-oceanbase-mcp-1.5.0.tgz
  • oceanbase-mcp-1.5.0-source.tar.gz
  • sbom.cdx.json
  • oceanbase-mcp-1.5.0-amd64.tar.gz
  • oceanbase-mcp-1.5.0-arm64.tar.gz
  • ghcr.io/sevoniva/oceanbase-mcp:v1.5.0
  • ghcr.io/sevoniva/oceanbase-mcp:1.5.0

源码构建

tar -xzf oceanbase-mcp-1.5.0-source.tar.gz
cd oceanbase-mcp-1.5.0
npm ci
npm run build
npm run start

源码归档不包含 node_modules 和 dist。npm registry 镜像需要能提供 package-lock.json 中锁定的依赖。

验证

  • npm test：通过。
  • npm run docs:check：通过。
  • npm audit --omit=dev --audit-level=moderate：通过。
  • npm pack --dry-run：通过，包名为 sevoniva-oceanbase-mcp-1.5.0.tgz。
  • Docker build：通过，镜像为 oceanbase-mcp:1.5.0。
  • 发布后已验证 npmjs 安装和 npx --package=@sevoniva/oceanbase-mcp@1.5.0 ob-mcp --help。

生产注意事项

  • 尽量使用只有 SELECT 和元数据查看权限的数据库账号；即使账号权限更大，MCP 层仍会保持只读。
  • HTTP 模式应配置 bearer token、Host allowlist、来源 IP allowlist，并放在 TLS 或可信反向代理之后。
  • 大 schema 先运行 ob_plan_er_export，再使用 CLI cluster 导出，不建议用 inline ER HTML。
  • 推断 ER 关系必须结合 confidence 和 evidence 判断。
Assets 7
Loading

OceanBase MCP v1.4.0

OceanBase MCP v1.4.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 03 Jul 12:17
v1.4.0
ad69731

OceanBase MCP v1.4.0

v1.4.0 is a packaging and public-documentation hygiene release. It does not change the read-only database boundary or add new database capabilities.

Changes

  • Trimmed the npm package file list to runtime assets, bilingual documentation, deployment templates, examples, OpenCode files, and CLI build output.
  • Excluded historical release-note files and smoke-test scripts from the npm package because they are not needed at runtime.
  • Kept GitHub source archives complete for source builds, audits, smoke tests, and release reproduction.
  • Updated package, server, Docker Compose, Kubernetes, README, and deployment examples to v1.4.0.

Validation

  • npm test: passed locally before release.
  • npm run docs:check: passed locally before release.
  • npm audit --omit=dev --audit-level=moderate: passed locally before release.
  • npm pack --dry-run: passed locally before release.
  • Release workflow must publish the npm package through GitHub Actions and attach the source archive, npm tgz, SBOM, and amd64/arm64 offline images.

Install

npm install -g @sevoniva/oceanbase-mcp@1.4.0
ob-mcp --help
npx --registry=https://registry.npmjs.org/ --yes --package=@sevoniva/oceanbase-mcp@1.4.0 ob-mcp --help

Assets

  • sevoniva-oceanbase-mcp-1.4.0.tgz
  • oceanbase-mcp-1.4.0-source.tar.gz
  • sbom.cdx.json
  • oceanbase-mcp-1.4.0-amd64.tar.gz
  • oceanbase-mcp-1.4.0-arm64.tar.gz
  • ghcr.io/sevoniva/oceanbase-mcp:v1.4.0
  • ghcr.io/sevoniva/oceanbase-mcp:1.4.0

Notes

  • Use the npm package for normal CLI and MCP runtime installation.
  • Use the GitHub source archive when tests, smoke scripts, or release reproduction are required.
  • Existing read-only SQL policy, profile permissions, tool permissions, output limits, timeout limits, audit logging, and error redaction remain unchanged.

中文说明

v1.4.0 是一次打包和公开文档整理版本。本版本不改变数据库只读边界，也不增加新的数据库能力。

变更

  • 精简 npm 包文件清单，只保留运行时产物、双语文档、部署模板、示例、OpenCode 文件和 CLI 构建产物。
  • npm 包不再包含历史 release 文档和 smoke 测试脚本；这些内容不是运行时必需。
  • GitHub 源码归档仍保持完整，适合源码构建、审计、smoke test 和发布复现。
  • package、server、Docker Compose、Kubernetes、README 和部署示例更新到 v1.4.0。

验证

  • npm test：发布前本地通过。
  • npm run docs:check：发布前本地通过。
  • npm audit --omit=dev --audit-level=moderate：发布前本地通过。
  • npm pack --dry-run：发布前本地通过。
  • Release workflow 需要通过 GitHub Actions 发布 npm 包，并附带源码归档、npm tgz、SBOM、amd64/arm64 离线镜像。

安装

npm install -g @sevoniva/oceanbase-mcp@1.4.0
ob-mcp --help
npx --registry=https://registry.npmjs.org/ --yes --package=@sevoniva/oceanbase-mcp@1.4.0 ob-mcp --help

交付资产

  • sevoniva-oceanbase-mcp-1.4.0.tgz
  • oceanbase-mcp-1.4.0-source.tar.gz
  • sbom.cdx.json
  • oceanbase-mcp-1.4.0-amd64.tar.gz
  • oceanbase-mcp-1.4.0-arm64.tar.gz
  • ghcr.io/sevoniva/oceanbase-mcp:v1.4.0
  • ghcr.io/sevoniva/oceanbase-mcp:1.4.0

说明

  • 常规 CLI 和 MCP runtime 安装使用 npm 包。
  • 需要测试、smoke 脚本或发布复现时，使用 GitHub 源码归档。
  • 既有只读 SQL 策略、profile 权限、tool 权限、输出限制、超时限制、审计日志和错误脱敏保持不变。
Loading

OceanBase MCP v1.3.0

OceanBase MCP v1.3.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 03 Jul 10:35
v1.3.0
b82a539

OceanBase MCP v1.3.0

v1.3.0 focuses on stability, performance protection, maintainability, and release readiness. It keeps the MCP surface strictly read-only and does not add write, DDL, DCL, procedure execution, or sequence NEXTVAL capability.

Changes

  • Added DB call budgets for tools that can read metadata or query data.
  • Added tool execution deadlines so late DB calls are rejected after the configured timeout budget is exhausted.
  • Kept large-schema and large-table paths bounded by rows, bytes, tables, columns, relationships, DB calls, and timeout limits.
  • Continued ER large-schema handling through export planning, clustered artifacts, and bounded inline responses.
  • Split DB runtime code into smaller modules for pool setup, query execution, metadata value helpers, and schema context helpers.
  • Added regression tests for DB runtime query handling, metadata value helpers, and schema context helpers.
  • Kept audit logs, structured error output, and sensitive value redaction in the tool runtime.
  • Updated current package, server, Docker Compose, Kubernetes, README, and deployment examples to v1.3.0.

Validation

  • npm test: passed, 268 tests.
  • npm run docs:check: passed, 38 Markdown files checked.
  • npm audit --omit=dev --audit-level=moderate --registry=https://registry.npmjs.org/: passed, 0 vulnerabilities.
  • npm pack --dry-run: passed for sevoniva-oceanbase-mcp-1.3.0.tgz.
  • Docker build: passed for oceanbase-mcp:1.3.0.
  • Local npm package install: passed; installed the generated tgz and verified ob-mcp --help.
  • Local OpenCode MCP startup: passed; opencode mcp list reported oceanbase connected.
  • Local OceanBase MySQL smoke test: passed on 5.7.25-OceanBase-v4.2.5.7.
  • Local OceanBase MySQL MCP smoke test: passed with server version 1.3.0.
  • Local OceanBase Oracle MCP smoke test: passed with object metadata, partition metadata, ER, snapshot, diff, impact, and read-only enforcement checks.
  • Large-schema verification: passed with 220 tables, 1,980 columns, 219 estimated relationships, and 4 DB calls.
  • Large-table verification: passed against biz_test.ob_mcp_million_describe with 1,048,576 rows; describeTable returned 5 columns without process restart.
  • ER HTML browser verification: passed for a 220-table export with 6 clusters and 220 table pages. The index and a cluster page opened in a real browser; the only observed console error was a missing favicon.

Install

npm install -g @sevoniva/oceanbase-mcp@1.3.0
ob-mcp --help
npx --registry=https://registry.npmjs.org/ --yes --package=@sevoniva/oceanbase-mcp@1.3.0 ob-mcp --help

Private registries can mirror npmjs and install the same pinned package version.

Offline Source Build

tar -xzf oceanbase-mcp-1.3.0-source.tar.gz
cd oceanbase-mcp-1.3.0
npm ci
npm run build
npm run start

The source archive does not include node_modules or dist. The npm registry used for the build must provide the dependencies locked in package-lock.json.

Assets

  • sevoniva-oceanbase-mcp-1.3.0.tgz
  • oceanbase-mcp-1.3.0-source.tar.gz
  • sbom.cdx.json
  • oceanbase-mcp-1.3.0-amd64.tar.gz
  • oceanbase-mcp-1.3.0-arm64.tar.gz
  • ghcr.io/sevoniva/oceanbase-mcp:v1.3.0
  • ghcr.io/sevoniva/oceanbase-mcp:1.3.0

Known Limits

  • Large schemas should use ob_plan_er_export or ob-mcp export-er --out-dir; inline MCP responses remain intentionally bounded.
  • Relationship planning is capped by configured limits. Increase limits only for a focused schema or table range.
  • OceanBase row counts and optimizer statistics may be estimated or stale.
  • Inferred relationships must be reviewed through confidence and evidence before being treated as design facts.

Production Notes

  • Database accounts should still use read-only privileges. MCP continues to block writes, DDL, DCL, procedure calls, sequence NEXTVAL, locks, and unsafe functions.
  • Keep OB_MAX_DB_CALLS, OB_METADATA_MAX_DB_CALLS, OB_ER_MAX_DB_CALLS, OB_MAX_RESULT_BYTES, tool timeouts, and concurrency limits aligned with local machine resources.
  • For large ER work, start with planning, then export clustered HTML to a directory.
  • Review diagnostics before sharing an ER export, especially when tables, columns, relationships, or DB calls were truncated by configured limits.

中文说明

v1.3.0 聚焦稳定性、性能保护、可维护性和发布交付。本版本继续保持 MCP 只读边界，不增加写入、DDL、DCL、过程执行或序列 NEXTVAL 能力。

变更

  • 增加工具级 DB 调用预算，覆盖可能读取元数据或查询数据的工具。
  • 增加工具执行截止时间；超过配置超时预算后，后续 DB 调用会被拒绝。
  • 大 schema 和大表路径继续受行数、字节数、表数、字段数、关系数、DB 调用次数和超时限制控制。
  • 大库 ER 继续通过导出规划、cluster artifact 和受限 inline 响应处理。
  • 拆分 DB runtime 代码，独立出连接池、查询执行、元数据取值 helper 和 schema 上下文 helper。
  • 增加 DB runtime 查询、元数据取值 helper 和 schema 上下文 helper 的回归测试。
  • 保持工具运行时审计日志、结构化错误输出和敏感信息脱敏。
  • 当前 package、server、Docker Compose、Kubernetes、README 和部署示例更新到 v1.3.0。

验证结果

  • npm test：通过，268 个测试。
  • npm run docs:check：通过，检查 38 个 Markdown 文件。
  • npm audit --omit=dev --audit-level=moderate --registry=https://registry.npmjs.org/：通过，0 个漏洞。
  • npm pack --dry-run：通过，包名为 sevoniva-oceanbase-mcp-1.3.0.tgz。
  • Docker build：通过，镜像为 oceanbase-mcp:1.3.0。
  • 本地 npm 包安装：通过，安装生成的 tgz 后验证 ob-mcp --help。
  • 本地 OpenCode MCP 启动：通过，opencode mcp list 显示 oceanbase connected。
  • 本地 OceanBase MySQL smoke test：通过，版本为 5.7.25-OceanBase-v4.2.5.7。
  • 本地 OceanBase MySQL MCP smoke test：通过，server version 为 1.3.0。
  • 本地 OceanBase Oracle MCP smoke test：通过，覆盖对象元数据、分区元数据、ER、snapshot、diff、impact 和只读拦截。
  • 大 schema 验证：通过，覆盖 220 张表、1,980 个字段、219 条估算关系，DB 调用 4 次。
  • 百万行表验证：通过，biz_test.ob_mcp_million_describe 有 1,048,576 行；describeTable 返回 5 个字段，服务未重启。
  • ER HTML 浏览器验证：通过，220 张表导出为 6 个 cluster 和 220 个表页面。index 和 cluster 页面均已在真实浏览器打开；唯一观察到的 console error 是缺失 favicon。

安装

npm install -g @sevoniva/oceanbase-mcp@1.3.0
ob-mcp --help
npx --registry=https://registry.npmjs.org/ --yes --package=@sevoniva/oceanbase-mcp@1.3.0 ob-mcp --help

私有 registry 可以同步 npmjs，并安装相同的固定版本。

离线源码构建

tar -xzf oceanbase-mcp-1.3.0-source.tar.gz
cd oceanbase-mcp-1.3.0
npm ci
npm run build
npm run start

源码归档不包含 node_modules 和 dist。构建使用的 npm registry 需要能提供 package-lock.json 中锁定的依赖。

交付资产

  • sevoniva-oceanbase-mcp-1.3.0.tgz
  • oceanbase-mcp-1.3.0-source.tar.gz
  • sbom.cdx.json
  • oceanbase-mcp-1.3.0-amd64.tar.gz
  • oceanbase-mcp-1.3.0-arm64.tar.gz
  • ghcr.io/sevoniva/oceanbase-mcp:v1.3.0
  • ghcr.io/sevoniva/oceanbase-mcp:1.3.0

已知限制

  • 大 schema 应使用 ob_plan_er_export 或 ob-mcp export-er --out-dir；MCP inline 响应会继续保持硬限制。
  • 关系规划受配置上限控制。需要更多关系时，应先缩小 schema 或 table 范围，再调整上限。
  • OceanBase 行数和优化器统计信息可能是估算值，也可能不是最新值。
  • inferred 关系需要结合 confidence 和 evidence 审阅后再作为设计事实使用。

生产注意事项

  • 数据库账号仍建议使用只读权限；MCP 会继续拦截写入、DDL、DCL、过程调用、序列 NEXTVAL、锁和危险函数。
  • OB_MAX_DB_CALLS、OB_METADATA_MAX_DB_CALLS、OB_ER_MAX_DB_CALLS、OB_MAX_RESULT_BYTES、工具超时和并发限制应与本机资源匹配。
  • 大库 ER 先做规划，再导出 cluster HTML 目录。
  • 分享 ER 导出前先查看 diagnostics，确认是否有表、字段、关系或 DB 调用被配置上限截断。
Loading

OceanBase MCP v1.2.0

OceanBase MCP v1.2.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 02 Jul 17:07
v1.2.0
a8440e6

OceanBase MCP v1.2.0

v1.2.0 rebuilds the ER diagram capability as a browsable OceanBase metadata map. The release keeps the read-only security boundary unchanged and focuses on large-schema stability, interactive ER navigation, diagnostics, and npmjs delivery.

Changes

  • Rebuilt ER metadata with stable internal graph IDs separated from display names, search names, and export names.
  • Added an interactive graph canvas for ER HTML with search, filters, zoom, table details, relationship details, and evidence panels.
  • Added clustered ER directory export for large schemas, including overview pages, cluster pages, table pages, graph metadata, relationship metadata, diagnostics, and export summary files.
  • Preserved cross-cluster relationships through relationship indexes and table-neighborhood pages instead of dropping them from large exports.
  • Classified relationships by source and confidence, with evidence for confirmed and inferred relationships.
  • Replaced expanded warning blocks in large ER exports with a status card and collapsed diagnostics.
  • Improved medium and large graph framing so generated pages open with readable table nodes and relationships.
  • Added response-size audit metadata for ER generation and export flows.
  • Hardened Oracle smoke validation for object metadata responses.
  • Kept MCP inline ER bounded; large schemas should use export-er --out-dir.

Validation

  • npm test: passed, 221 tests.
  • npm run docs:check: passed, 36 Markdown files checked.
  • npm audit --omit=dev --audit-level=moderate: passed against the npmjs registry.
  • npm pack --dry-run: passed.
  • Docker build: passed for oceanbase-mcp:1.2.0.
  • Local OceanBase MySQL stdio smoke test: passed.
  • Local OceanBase MySQL HTTP smoke test: passed.
  • Local OceanBase Oracle stdio smoke test: passed.
  • Local OceanBase Oracle HTTP smoke test: passed.
  • Local large-schema ER export, MySQL mode: 222 tables, 9 clusters, 222 table pages.
  • Local large-schema ER export, Oracle mode: 340 tables, 15 clusters, 340 table pages.
  • Browser QA: index page status and diagnostics rendered correctly; cluster pages opened without console errors; search, table click, and relationship evidence panels worked.
  • Large-table metadata check: MySQL table statistics validated with a 1,048,576-row table without scanning business rows. Oracle metadata paths were validated locally and through regression tests.

Install

npm install -g @sevoniva/oceanbase-mcp@1.2.0
ob-mcp --help
npx --registry=https://registry.npmjs.org/ --yes --package=@sevoniva/oceanbase-mcp@1.2.0 ob-mcp --help

Private registries can mirror npmjs and install the same pinned package version.

Offline Source Build

tar -xzf oceanbase-mcp-1.2.0-source.tar.gz
cd oceanbase-mcp-1.2.0
npm ci
npm run build
npm run start

The source archive does not include node_modules or dist. The private npm registry must provide the dependencies locked in package-lock.json.

Assets

  • sevoniva-oceanbase-mcp-1.2.0.tgz
  • oceanbase-mcp-1.2.0-source.tar.gz
  • sbom.cdx.json
  • oceanbase-mcp-1.2.0-amd64.tar.gz
  • oceanbase-mcp-1.2.0-arm64.tar.gz
  • ghcr.io/sevoniva/oceanbase-mcp:v1.2.0
  • ghcr.io/sevoniva/oceanbase-mcp:1.2.0

Known Limits

  • Large schemas should use ob_plan_er_export or ob-mcp export-er --out-dir; inline MCP responses remain intentionally bounded.
  • Relationship planning is capped by configured limits. Increase the limit only for a focused schema or table range.
  • OceanBase row counts and optimizer statistics may be estimated or stale.
  • Inferred relationships must be reviewed through confidence and evidence before being treated as design facts.

Production Notes

  • Database accounts should still use read-only privileges. MCP continues to block writes, DDL, DCL, procedure calls, sequence NEXTVAL, locks, and unsafe functions.
  • Keep OB_ER_MAX_TABLES, OB_MAX_RESULT_BYTES, tool timeouts, and concurrency limits aligned with local machine resources.
  • For large ER work, start with planning, then export clustered HTML to a directory.
  • Review diagnostics before sharing an ER export, especially when tables, columns, or relationships were truncated by configured limits.

中文说明

v1.2.0 将 ER 图能力重构为可浏览的 OceanBase 元数据地图。本版本保持只读安全边界不变，重点改善大库稳定性、交互式 ER 浏览、诊断信息和 npmjs 分发。

变更

  • 重构 ER 元数据模型，稳定内部 graph ID 与展示名、搜索名、导出名分离。
  • 新增交互式 ER HTML 画布，支持搜索、筛选、缩放、表详情、关系详情和证据面板。
  • 新增大库 cluster 目录导出，包含总览页、cluster 页、表详情页、graph 元数据、关系元数据、诊断信息和导出摘要。
  • 通过关系索引和表邻域页面保留跨 cluster 关系，避免大库导出丢关系。
  • 按来源和置信度对关系分级，confirmed 和 inferred 关系都带 evidence。
  • 大库 ER 导出不再展开大量 warning，改为顶部状态卡和折叠诊断面板。
  • 优化中大型图初始视角，页面打开后表节点和关系更容易阅读。
  • ER 生成和导出流程增加响应大小审计信息。
  • 加强 Oracle smoke test 的对象元数据响应校验。
  • MCP inline ER 保持有界；大 schema 应使用 export-er --out-dir。

验证结果

  • npm test：通过，221 个测试。
  • npm run docs:check：通过，检查 36 个 Markdown 文件。
  • npm audit --omit=dev --audit-level=moderate：通过，使用 npmjs registry 验证。
  • npm pack --dry-run：通过。
  • Docker build：通过，镜像 tag 为 oceanbase-mcp:1.2.0。
  • 本地 OceanBase MySQL stdio smoke test：通过。
  • 本地 OceanBase MySQL HTTP smoke test：通过。
  • 本地 OceanBase Oracle stdio smoke test：通过。
  • 本地 OceanBase Oracle HTTP smoke test：通过。
  • 本地 MySQL 大库 ER 导出：222 张表、9 个 cluster、222 个表详情页。
  • 本地 Oracle 大库 ER 导出：340 张表、15 个 cluster、340 个表详情页。
  • 浏览器验证：index 页状态和诊断正常；cluster 页无控制台错误；搜索、表点击、关系证据面板可用。
  • 大表元数据验证：MySQL 1,048,576 行表统计验证通过，未扫描业务行；Oracle 元数据路径已通过本地验证和回归测试覆盖。

安装

npm install -g @sevoniva/oceanbase-mcp@1.2.0
ob-mcp --help
npx --registry=https://registry.npmjs.org/ --yes --package=@sevoniva/oceanbase-mcp@1.2.0 ob-mcp --help

私有 registry 可以同步 npmjs，并安装相同的固定版本。

离线源码构建

tar -xzf oceanbase-mcp-1.2.0-source.tar.gz
cd oceanbase-mcp-1.2.0
npm ci
npm run build
npm run start

源码归档不包含 node_modules 和 dist。私有 npm registry 需要能提供 package-lock.json 中锁定的依赖。

交付资产

  • sevoniva-oceanbase-mcp-1.2.0.tgz
  • oceanbase-mcp-1.2.0-source.tar.gz
  • sbom.cdx.json
  • oceanbase-mcp-1.2.0-amd64.tar.gz
  • oceanbase-mcp-1.2.0-arm64.tar.gz
  • ghcr.io/sevoniva/oceanbase-mcp:v1.2.0
  • ghcr.io/sevoniva/oceanbase-mcp:1.2.0

已知限制

  • 大 schema 应使用 ob_plan_er_export 或 ob-mcp export-er --out-dir；MCP inline 响应会继续保持硬限制。
  • 关系规划受配置上限控制。需要更多关系时，应先缩小 schema 或 table 范围，再调整上限。
  • OceanBase 行数和优化器统计信息可能是估算值，也可能不是最新值。
  • inferred 关系需要结合 confidence 和 evidence 审阅后再作为设计事实使用。

生产注意事项

  • 数据库账号仍建议使用只读权限；MCP 会继续拦截写入、DDL、DCL、过程调用、序列 NEXTVAL、锁和危险函数。
  • OB_ER_MAX_TABLES、OB_MAX_RESULT_BYTES、工具超时和并发限制应与本机资源匹配。
  • 大库 ER 先做规划，再导出 cluster HTML 目录。
  • 分享 ER 导出前先查看 diagnostics，确认是否有表、字段或关系被配置上限截断。
Loading

OceanBase MCP v1.1.4

OceanBase MCP v1.1.4

Choose a tag to compare

View all tags
@github-actions github-actions released this 02 Jul 07:38
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 配置。
Loading

OceanBase MCP v1.1.3

OceanBase MCP v1.1.3

Choose a tag to compare

View all tags
@github-actions github-actions released this 02 Jul 06:42
v1.1.3
d5b64d0

OceanBase MCP v1.1.3

v1.1.3 is a stability patch for large-schema ER planning and export. It reduces metadata load before export, adds explicit ER chunking options, and verifies the flow against local OceanBase schemas with more than 200 complex tables. The read-only boundary is unchanged.

Changes

  • ob_plan_er_export now uses lightweight table statistics and batched foreign-key metadata instead of loading full table details during planning.
  • The ER export CLI supports --strategy and --max-columns-per-table.
  • Connected-component and table-prefix export strategies now pack small isolated components into bounded chunks.
  • MySQL table listing includes estimated row counts where available.
  • ER planning output now reports estimated table count, estimated column count, estimated relationship count, large tables, risks, recommended next tools, and chunk commands.
  • OpenCode and deployment documentation now point to the current large-schema ER workflow and v1.1.3 release assets.

Validation

  • npm test: 211 tests passed.
  • npm run docs:check: passed.
  • npm audit --omit=dev --audit-level=moderate: passed.
  • npm pack --dry-run: passed.
  • Docker build: passed.
  • Local OceanBase MySQL stdio and HTTP smoke tests passed.
  • Local OceanBase Oracle stdio and HTTP smoke tests passed.
  • MySQL ER export: 222 tables, 5 chunks, 215 rendered relationships, 219 planned relationships.
  • Oracle ER export: 352 tables, 8 chunks, 220 rendered relationships, 224 planned relationships.
  • Oracle validation includes all 220 OB_MCP_LG_* complex test tables and covers a larger visible schema than the MySQL validation.
  • Small-scope MySQL and Oracle ER HTML exports passed.
  • MySQL and Oracle million-row ob_describe_table validations passed without scanning table data.
  • Oracle OB_MCP_MILLION_DESCRIBE was verified with 1,048,576 rows after bounded batch data preparation.

Internal Build

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

The source archive does not include node_modules or dist. The internal npm repository must provide the dependencies locked in package-lock.json.

Assets

  • ob-mcp-1.1.3.tgz
  • ob-mcp-1.1.3-source.tar.gz
  • sbom.cdx.json
  • oceanbase-mcp-1.1.3-amd64.tar.gz
  • oceanbase-mcp-1.1.3-arm64.tar.gz
  • ghcr.io/sevoniva/oceanbase-mcp:v1.1.3

中文说明

v1.1.3 是大 schema ER 规划和导出的稳定性补丁。重点是降低导出前的元数据加载量，增加明确的 ER 分片参数，并用本地 OceanBase 200+ 复杂表完成验证。只读安全边界不变。

变更

  • ob_plan_er_export 改为使用轻量表统计和批量外键元数据，不再在规划阶段加载完整表详情。
  • ER 导出 CLI 增加 --strategy 和 --max-columns-per-table。
  • connected-components 和 table-prefix 分片策略会把较小的孤立组件合并到受控 chunk 中。
  • MySQL 表列表在可用时返回估算行数。
  • ER 规划输出增加估算表数、估算字段数、估算关系数、大表提示、风险、推荐下一步工具和分片命令。
  • OpenCode 和部署文档已更新到当前大 schema ER 工作流和 v1.1.3 交付资产。

验证

  • npm test：211 个测试通过。
  • 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 ER 导出：222 张表、5 个 chunk、215 条渲染关系、219 条规划关系。
  • Oracle ER 导出：352 张表、8 个 chunk、220 条渲染关系、224 条规划关系。
  • Oracle 验证包含全部 220 张 OB_MCP_LG_* 复杂测试表，可见 schema 覆盖范围大于 MySQL 验证。
  • MySQL 和 Oracle 小范围 ER HTML 导出通过。
  • MySQL 和 Oracle 百万行表 ob_describe_table 验证通过，未扫描目标表数据。
  • Oracle OB_MCP_MILLION_DESCRIBE 已用 1,048,576 行真实数据验证，数据准备采用受控分批写入。

内网编译

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

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

交付资产

  • ob-mcp-1.1.3.tgz
  • ob-mcp-1.1.3-source.tar.gz
  • sbom.cdx.json
  • oceanbase-mcp-1.1.3-amd64.tar.gz
  • oceanbase-mcp-1.1.3-arm64.tar.gz
  • ghcr.io/sevoniva/oceanbase-mcp:v1.1.3
Loading

OceanBase MCP v1.1.2

OceanBase MCP v1.1.2

Choose a tag to compare

View all tags
@github-actions github-actions released this 02 Jul 05:48
v1.1.2
c5c8ac5

OceanBase MCP v1.1.2

This release improves local OpenCode query stability for OceanBase MCP. It raises the default local HTTP rate limit for tool-heavy workflows, adds crash and slow-call logs, and accepts common Oracle named bind placeholders when positional params are supplied. The server remains strictly read-only.

新增能力

  • 本地 HTTP 默认限流从每分钟 60 次调整为 600 次，适配 OpenCode 连续元数据查询、预览和分页调用。
  • 生产环境或非本地绑定仍默认每分钟 60 次，保持共享部署的保守边界。
  • OB_MCP_LOG_FILE 支持 JSONL 日志落盘，便于排查 stdio 场景下的 OpenCode 断连。
  • 新增进程级崩溃日志、慢工具调用日志、慢 HTTP 请求日志、HTTP 限流日志和 JSON body 错误日志。
  • Oracle 模式在传入 params 数组时兼容简单 :name 和 :1 占位符，执行前转换为驱动可识别的参数形式。
  • 占位符转换会跳过字符串、标识符和注释，避免改写 SQL 文本内容。
  • SQL 辅助文档补充 Oracle 参数化写法，仍建议生成 MCP 调用时优先使用 ? 位置占位符。
  • 只读策略、profile 权限、行数限制、输出大小限制、超时、审计日志和错误脱敏保持不变。

Delivery Assets

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

内网源码编译

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

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

验证要求

  • OceanBase MySQL 模式 smoke test 和连续查询压测通过。
  • OceanBase Oracle 模式 smoke test、命名占位符查询预览和连续查询压测通过。
  • 本地 HTTP 连续调用压测通过，未触发默认限流。
  • JSONL 日志落盘和敏感字段脱敏单元测试通过。
  • npm test、npm run docs:check、npm audit --omit=dev --audit-level=moderate、npm pack --dry-run、Docker build 通过。

生产注意事项

  • 建议数据库账号仍使用只读权限；MCP 会继续拦截写入、DDL、DCL、过程调用和序列 NEXTVAL。
  • 本地排查 OpenCode 断连时建议配置 OB_MCP_LOG_FILE=/var/log/ob-mcp/ob-mcp.jsonl。
  • 本地 OpenCode 推荐使用 stdio；如使用 HTTP，本地默认限流为 600 次/分钟，可通过 OB_MCP_RATE_LIMIT_MAX 显式调整。
  • 生产或非本地 HTTP 绑定必须配置鉴权、Host allowlist 和来源 IP allowlist。
  • Oracle 模式生成新 SQL 时仍优先使用 ? 位置占位符，避免重复命名参数带来的歧义。
  • OpenCode 使用前建议先加载随包提供的 Agent/Skill 配置。
Loading

OceanBase MCP v1.1.1

OceanBase MCP v1.1.1

Choose a tag to compare

View all tags
@github-actions github-actions released this 02 Jul 05:03
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 配置。
Loading

OceanBase MCP v1.1.0

OceanBase MCP v1.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 02 Jul 00:55
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 配置。
Loading

OceanBase MCP v1.0.0

OceanBase MCP v1.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 01 Jul 15:05
v1.0.0
792c805

OceanBase MCP v1.0.0

v1.0.0 completes the local OceanBase Developer Assistant scope for OpenCode. It improves metadata discovery, read-only SQL assistance, paged query workflows, ER diagrams, data dictionaries, project SQL scanning, local setup checks, and internal delivery assets. The server remains strictly read-only.

新增能力

  • 本地初始化和诊断：ob-mcp init、ob-mcp doctor、ob_check_opencode_setup、ob_get_usage_guide、ob_list_capabilities。
  • 元数据和字典：schema map、统一搜索、业务词找表、跨表找字段、表摘要、数据库字典、表和 schema 对比。
  • SQL 辅助：查询准备、结构化 SELECT 构建、SQL lint、SQL 改写、MySQL/Oracle 方言转换、错误解释和查询示例。
  • 查询体验：内存查询会话、上一页/下一页、查询细化、结果摘要、结果对比和 Markdown/CSV 预览。
  • 数据理解：表画像、字段画像增强、值分布、时间字段识别、维度字段识别、最近数据查询和数据质量检查。
  • ER 图：Mermaid、JSON、HTML static/interactive/compact/detailed、实体图、关系解释、Markdown/PlantUML/DOT 文档和 CLI 导出。
  • 项目代码辅助：ob-mcp scan-sql、SQL 片段校验、项目 SQL 解释、mapper 上下文和未知字段候选。
  • 文档生成：表文档、schema 文档、数据字典、SQL 文档和新开发者入门文档。

Delivery Assets

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

内网源码编译

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

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

验证结果

  • OceanBase MySQL 模式：npm run smoke、npm run mcp:smoke、npm run http:smoke 通过。
  • OceanBase Oracle 模式：npm run mcp:smoke:oracle、npm run http:smoke:oracle 通过。
  • 1.0 核心 smoke 覆盖：schema map、prepare query、build select、lint sql、query session、ER HTML、data dictionary、project SQL validation。
  • 工程检查：npm test、npm run docs:check、npm audit --omit=dev --audit-level=moderate、npm pack --dry-run、Docker build 通过。

生产注意事项

  • 建议数据库账号仍使用只读权限；MCP 会继续拦截写入、DDL、DCL、过程调用、序列 NEXTVAL、锁表、文件函数和 sleep。
  • 业务字典只用于搜索提示，结果仍受 profile、schema、table、column 权限过滤。
  • 字段画像、数据质量和最近数据查询使用受限查询，不做无边界全表扫描。
  • ER 图关系来自约束、索引或带证据的保守推断，低置信度关系不能当作真实外键。
  • OpenCode 使用前建议先加载随包提供的 Agent/Skill 配置。
Loading