OceanBase MCP Server

功能简介

OceanBase MCP Server 是一款为 OceanBase 数据库打造的 MCP 服务端，实现了安全可控的数据库交互通道。它让 AI 助手可以在受控环境下，读取表数据、执行 SQL 查询，便于数据库探索与分析，同时保障数据安全。

主要功能特性

• • 列出

OceanBase

•  数据库中的表资源• 读取表内容• 执行

SQL

 查询并提供异常处理• 通过环境变量实现安全的数据库访问• 全面日志记录，便于审计和追踪

快速开始指引

1. 克隆项目代码：⁠

git clone https://github.com/oceanbase/mcp-oceanbase.git⁠

1. 2. 安装 Python 包管理器 uv 并创建虚拟环境3. 复制

⁠.env.template

1. ⁠ 为

⁠.env⁠

1.  并配置数据库连接信息4. 安装依赖：⁠`uv pip install .⁠``5. 选择

stdio

1.  或

sse

 模式启动 MCP Server

可用工具

• • 执行

SQL

•  查询• 获取当前租户信息• 获取所有服务器节点（仅 sys 租户）• 获取资源容量（仅 sys 租户）• 获取

ASH

 报告• 官方文档检索（实验性）

MCP配置

可通过环境变量（OB_HOST、OB_PORT、OB_USER、OB_PASSWORD、OB_DATABASE）或 .env 文件配置数据库连接参数。支持 stdio 和 sse 两种通讯模式，端口、主机可自定义。

{
  "mcpServers": {
    "oceanbase": {
      "command": "uv",
      "args": [
        "--directory", 
        "path/to/mcp-oceanbase",
        "run",
        "oceanbase_mcp_server"
      ],
      "env": {
        "OB_HOST": "localhost",
        "OB_PORT": "2881",
        "OB_USER": "your_username",
        "OB_PASSWORD": "your_password",
        "OB_DATABASE": "your_database",
        "UV_DEFAULT_INDEX": "https://mirrors.aliyun.com/pypi/simple/"
      }
    }
  }
}

项目地址

github:https://github.com/oceanbase/mcp-oceanbase

获取密钥流程：https://qianniucity.feishu.cn/wiki/WSBYwhIBbixbsNkyhoxcV4U9nKe?from=from_copylink

完整操作流程：https://qianniucity.feishu.cn/wiki/Iy5PwuYuCiPwrQk6xTgc5j6Anob?from=from_copylink

#OceanBase  #MCP  #数据库安全  #AI助手  #SQL