# OceanBase

执行数据库 SQL，查询租户与诊断信息，并支持全文、向量检索及可选记忆管理。

- 类型：MCP
- 权限：可执行操作
- 门槛：见接入前准备
- 官方入口：https://github.com/oceanbase/awesome-oceanbase-mcp/tree/main/src/oceanbase_mcp_server
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/oceanbase/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。修改或发送前须告知用户。

## 接入前准备

需已有可连接的 OceanBase 实例及数据库凭证，准备 uv 和 Python 3.10 至 3.12；本地部署与云实例条件不同，云资源费用另按产品规则计算。实验性记忆功能默认关闭，不是基础 SQL 接入的必选项。

## 接入步骤

1. 从实例或租户获取地址、端口和数据库凭证；首次验证使用已有只读账号或只读权限，确认客户端能访问数据库网络。 [官方入口](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005282562)
2. 按官方 PyPI 路径，将下方 uvx 配置添加到客户端，逐项替换 OB_HOST、OB_PORT、OB_USER、OB_PASSWORD 和 OB_DATABASE；使用受支持的 Python 环境。 [官方入口](https://github.com/oceanbase/awesome-oceanbase-mcp/tree/main/src/oceanbase_mcp_server)
3. 如改用源码部署，进入仓库的 src/oceanbase_mcp_server 子目录并按其 README 安装，不要将仓库根目录下的其他 MCP 组件当成同一启动入口。 [官方入口](https://github.com/oceanbase/awesome-oceanbase-mcp/tree/main/src/oceanbase_mcp_server)

## 验证方法

先确认客户端列出 OceanBase 工具，再对已授权数据库执行 SHOW TABLES 并核对结果；写 SQL 和记忆写入需按实际权限与任务授权执行。

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

所查官方接入资料未能确认该工具的具体调用费用和免费额度；实际费用按官方产品规则核实。 [官方来源](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005282562)（核对日期：2026-11-05）

## 安装配置

### JSON

```
{
  "mcpServers": {
    "oceanbase": {
      "command": "uvx",
      "args": [
        "--from",
        "oceanbase-mcp",
        "oceanbase_mcp_server"
      ],
      "env": {
        "OB_HOST": "${OB_HOST}",
        "OB_PORT": "${OB_PORT}",
        "OB_USER": "${OB_USER}",
        "OB_PASSWORD": "${OB_PASSWORD}",
        "OB_DATABASE": "${OB_DATABASE}"
      }
    }
  }
}
```

### Claude Code

```
claude mcp add --env 'OB_HOST=${OB_HOST}' --env 'OB_PORT=${OB_PORT}' --env 'OB_USER=${OB_USER}' --env 'OB_PASSWORD=${OB_PASSWORD}' --env 'OB_DATABASE=${OB_DATABASE}' --transport stdio 'oceanbase' -- 'uvx' '--from' 'oceanbase-mcp' 'oceanbase_mcp_server'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.oceanbase]
command = "uvx"
args = ["--from","oceanbase-mcp","oceanbase_mcp_server"]
env_vars = ["OB_HOST","OB_PORT","OB_USER","OB_PASSWORD","OB_DATABASE"]
```

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

命令会进入 shell 历史，请在本地执行，不要分享。保留命令中的 ${VAR} 引用；Codex 不支持在 URL 或命令参数中展开这些引用，此处保留待本地处理的占位符。

## 核验与来源

2026-11-05 核对官方身份：[依据](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005282562)。OceanBase 官方集成文档反向链接官方 MCP 仓库，专用说明给出 SQL、诊断、检索及可选记忆工具。

官方原文摘录（2026-11-05，来自上述依据）：

```
git clone https://github.com/oceanbase/awesome-oceanbase-mcp.git
```


[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)