OceanBase MCP Server 与 Continue 集成

MCP（Model Context Protocol） 是 Anthropic 公司于 2024 年 11 月推出并开源，旨在实现大语言模型与外部工具或数据源交互的协议。通过 MCP，用户不需要将大模型的输出手动复制执行，大模型可以直接指挥工具执行相应的动作（Action）。

OceanBase MCP Server 通过 MCP 协议提供了大模型与 OceanBase 数据库交互的能力，可以执行 SQL 语句。通过合适的客户端可以快速搭建项目原型，已在 github 上开源。

Continue 是一款可集成 MCP Server 的 IDE 插件，支持 Visual Studio Code 和 IntelliJ IDEA。

本文将展示如何使用 Continue 与 OceanBase MCP Server 集成，快速构建后端应用程序。

前提条件

• 您已完成部署 OceanBase 数据库并且创建了 MySQL 模式用户租户。创建用户租户的详细信息，参见 创建租户。

• 安装 Python 3.11 及以上版本 和相应 pip。如果您的机器上 Python 版本较低，可以使用 Miniconda 来创建新的 Python 3.11 及以上的环境，具体可参考 Miniconda 安装指南。

• 根据所用的操作系统，安装 Git。

• 安装 Python 包管理器 uv。安装完成后，可使用 uv --version 命令验证安装是否成功：

  pip install uv
  uv --version
  

• 使用 Visual Studio Code 或 IntelliJ IDEA 安装 Continue 插件，插件名称为 Continue。

  

  • 安装完成后，点击 Add Models，为 Continue 配置大模型 API。API 配置示例如下：

    

    • 配置文件示例如下：

      name: Local Assistant
      version: 1.0.0
      schema: v1
      models:
          # 模型名称
          - name: DeepSeek-R1-671B
          # 模型厂商
          provider: deepseek
          # 模型类型
          model: DeepSeek-R1-671B
          # 模型访问的 URL 地址
          apiBase: *********
          # 模型访问的 API 密钥
          apiKey: ********
      # 上下文提供者
      context:
          - provider: code
          - provider: docs
          - provider: diff
          - provider: terminal
          - provider: problems
          - provider: folder
          - provider: codebase
      

步骤一：获取数据库连接信息

联系 OceanBase 数据库部署人员或者管理员获取相应的数据库连接串，例如：

obclient -h$host -P$port -u$user_name -p$password -D$database_name

参数说明：

• $host：提供 OceanBase 数据库连接 IP。OceanBase 数据库代理（OceanBase Database Proxy，ODP）连接方式使用的是一个 ODP 地址；直连方式使用的是 OBServer 节点的 IP 地址。

• $port：提供 OceanBase 数据库连接端口。ODP 连接的方式默认是 2883，在部署 ODP 时可自定义；直连方式默认是 2881，在部署 OceanBase 数据库时可自定义。

• $database_name：需要访问的数据库名称。

  注意

  连接租户的用户需要拥有该数据库的 CREATE、INSERT、DROP 和 SELECT 权限。更多有关用户权限的信息，请参见 MySQL 模式下的权限分类。

• $user_name：提供租户的连接账户。ODP 连接的常用格式：用户名@租户名#集群名 或者 集群名:租户名:用户名；直连方式格式：用户名@租户名。

• $password：提供账户密码。

更多连接串的信息，请参见 通过 OBClient 连接 OceanBase 租户。

步骤二：配置 OceanBase MCP Server

克隆 OceanBase MCP Server 仓库

执行下面的命令将源代码下载到本地：

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

进入源代码目录：

cd mcp-oceanbase

安装依赖

在 mcp-oceanbase 目录下执行下面的命令创建虚拟环境，并安装依赖：

uv venv
source .venv/bin/activate
uv pip install .

添加并配置 MCP Servers

1. 点击对话框上方菜单栏最右侧按钮，打开 MCP 面板。

   

2. 点击添加 MCP Servers。

   注意

   MCP 仅可在 Continue 的 Agent 模式下使用。

   

3. 填写配置文件，点击确认。

   /path/to/your/mcp-oceanbase/src/oceanbase_mcp_server 需要替换为 oceanbase_mcp_server 文件夹的绝对路径，OB_HOST、OB_PORT、OB_USER、OB_PASSWORD、OB_DATABASE 需要替换为自己数据库的对应信息：

   name: OceanBase
   version: 0.0.1
   schema: v1
   mcpServers:
       - name: OceanBase
           command: uv
           args:
           - --directory
           - /path/to/your/mcp-oceanbase/src/oceanbase_mcp_server
           - run 
           - oceanbase_mcp_server
       env: 
           OB_HOST: "****"
           OB_PORT: "***"
           OB_USER: "***"
           OB_PASSWORD: "***"
           OB_DATABASE: "***"
   

4. 如配置成功，将显示以下内容：