Skip to main content
Glama
cornyu

Database MCP Server

by cornyu
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Database MCP Server

多数据库 MCP 服务器，支持 Oracle、OceanBase（Oracle 模式 + MySQL 模式）和 DolphinDB。

通过 MCP 协议（stdio 传输）与 Claude Desktop 等客户端通信，提供 SQL 查询、元数据查看和 Sequence 管理能力。

环境要求

  • Python >= 3.10（项目自带 venv，通过 uv 管理）

  • 目标数据库可达（本机或网络）

快速开始

1. 安装依赖

项目使用 uv 管理 Python 环境和依赖：

# 安装 uv（如果没有）
pip install uv

# 创建虚拟环境并安装依赖（已安装则跳过）
uv venv --python 3.11
uv pip install -r requirements.txt

# 如果用 DolphinDB，额外安装
uv pip install dolphindb

2. 配置数据库连接

复制配置示例文件并修改：

cp db_config.example.json db_config.json

配置文件按环境（dev / uat / pro）组织，每个环境可以配置多个数据库连接：

{
  "dev": {
    "oracle_dev": {
      "type": "oracle",
      "host": "192.168.1.10",
      "port": 1521,
      "service_name": "DEVPDB",
      "user": "dev_user",
      "password": "dev_pass"
    },
    "ob_mysql": {
      "type": "oceanbase_mysql",
      "host": "192.168.1.11",
      "port": 2883,
      "database": "test",
      "user": "root@obmysql",
      "password": ""
    }
  },
  "uat": {
    "oracle_dev": {
      "type": "oracle",
      "host": "192.168.2.10",
      "port": 1521,
      "service_name": "UATPDB",
      "user": "uat_user",
      "password": "${UAT_ORACLE_PWD}"
    }
  }
}

连接类型说明：

type

说明

必需参数

oracle

Oracle 或 OceanBase Oracle 模式

host, port, service_name, user, password

oceanbase_mysql

OceanBase MySQL 模式

host, port, user, password, database

dolphindb

DolphinDB

host, port, user, password

密码支持通过 ${VAR_NAME} 从环境变量读取，避免明文存储。

3. 选择运行环境

通过 DB_ENV 环境变量切换（默认 dev）：

# Windows CMD
set DB_ENV=uat

# PowerShell
$env:DB_ENV="uat"

# Bash
export DB_ENV=pro

启动服务器

# 方式一
uv run python main.py

# 方式二
uv run python -m server

服务器启动后会通过 stdio 等待 MCP 客户端连接，没有网络端口暴露。

注册到 Claude Desktop

在 Claude Desktop 配置文件（claude_desktop_config.json）中添加：

{
  "mcpServers": {
    "db": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "E:/python/workspace/mcp-server-databases",
        "python",
        "-m",
        "server"
      ],
      "env": {
        "DB_ENV": "dev",
        "DB_CONFIG_PATH": "E:/python/workspace/mcp-server-databases/db_config.json"
      }
    }
  }
}

如需同时连接多个环境，注册多个 server：

{
  "mcpServers": {
    "db-dev": {
      "command": "uv",
      "args": ["run", "--directory", "E:/...", "python", "-m", "server"],
      "env": { "DB_ENV": "dev" }
    },
    "db-pro": {
      "command": "uv",
      "args": ["run", "--directory", "E:/...", "python", "-m", "server"],
      "env": { "DB_ENV": "pro" }
    }
  }
}

注册到 OpenCode

在项目根目录创建 opencode.json（或编辑全局配置 ~/.config/opencode/opencode.jsonc），添加 MCP 服务器配置：

{
  "mcp": {
    "db": {
      "type": "local",
      "command": [
        "uv",
        "run",
        "--directory",
        "E:/python/workspace/mcp-server-databases",
        "python",
        "-m",
        "server"
      ],
      "enabled": true,
      "environment": {
        "DB_ENV": "dev",
        "DB_CONFIG_PATH": "E:/python/workspace/mcp-server-databases/db_config.json"
      }
    }
  }
}

如需同时连接多个环境，添加多个 server：

{
  "mcp": {
    "db-dev": {
      "type": "local",
      "command": ["uv", "run", "--directory", "E:/...", "python", "-m", "server"],
      "enabled": true,
      "environment": { "DB_ENV": "dev" }
    },
    "db-pro": {
      "type": "local",
      "command": ["uv", "run", "--directory", "E:/...", "python", "-m", "server"],
      "enabled": false,
      "environment": { "DB_ENV": "pro" }
    }
  }
}

"enabled": false 的 server 不会随 OpenCode 启动，需要时手动启用。

OpenCode 与 Claude Desktop 格式对比

项目

OpenCode

Claude Desktop

配置文件名

opencode.json / opencode.jsonc

claude_desktop_config.json

顶层键

"mcp"

"mcpServers"

类型字段

"type": "local"

无（默认 stdio）

命令格式

"command": [列表]

"command" + "args" 分开

环境变量

"environment"

"env"

启用开关

"enabled"

无

工具说明

所有工具都接受 connection 参数指定用哪个数据库连接，省略则使用第一个配置的连接。

工具

参数

说明

query

connection, sql

执行 SELECT 查询，返回 Markdown 表格

execute

connection, sql

执行 INSERT/UPDATE/DELETE/DDL

list_schemas

connection

列出所有 Schema / 数据库

list_tables

connection, schema

列出指定 Schema 下的表

describe_table

connection, table_name, schema

查看表结构（列名、类型、可空、主键）

list_sequences

connection, schema

列出所有 Sequence（仅 Oracle）

get_sequence_value

connection, sequence_name, schema

获取 Sequence 当前值

alter_sequence

connection, sequence_name, schema, increment_by, min_value, max_value, cycle, cache, order_flag

修改 Sequence 属性

set_sequence_value

connection, sequence_name, value, schema

将 Sequence 设为指定值

安全

  • execute 工具：可通过环境变量 DENY_EXECUTE=true 禁用写操作

  • 数据库侧权限：连接配置使用什么数据库账号就有什么权限，建议生产环境使用只读账号

  • 密码保护：使用 ${VAR_NAME} 引用环境变量，密码不写入配置文件

  • 无网络端口：纯 stdio 通信，不暴露网络服务

配置参考

所有环境变量

变量

默认值

说明

DB_CONFIG_PATH

./db_config.json

配置文件路径

DB_ENV

dev

运行环境（dev/uat/pro）

DENY_EXECUTE

false

设为 true 禁用写入操作

项目依赖

包

版本要求

用途

mcp

>=1.0.0

MCP Python SDK

oracledb

>=2.0.0

Oracle / OceanBase Oracle 驱动

pymysql

>=1.0.0

OceanBase MySQL 驱动

dolphindb

>=1.0.0（可选）

DolphinDB 驱动

cryptography

>=42.0.0

oracledb 加密依赖

This server cannot be installed

-
license - not tested
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cornyu/mcp-server-databases'

If you have feedback or need assistance with the MCP directory API, please join our Discord server