MCP DM8 服务器

TypeScript 版达梦 DM8 Model Context Protocol (MCP) 服务，提供表结构浏览和只读查询能力，支持代理连接。

🚀 快速开始（推荐方式）

方式一：直接使用 npx（无需安装）

npx mcp-dm8-server --host 127.0.0.1 --port 5236 --username SYSDBA --password 密码 --schema SYSDBA

方式二：全局安装后使用

# 全局安装
npm install -g mcp-dm8-server

# 使用命令
mcp-dm8 --host 127.0.0.1 --port 5236 --username SYSDBA --password 密码 --schema SYSDBA

方式三：代理连接使用

npx mcp-dm8-server \
  --host your_dm_host \
  --username SYSDBA \
  --password 密码 \
  --schema SYSDBA \
  --proxy-enabled \
  --proxy-host proxy.company.com \
  --proxy-port 8080 \
  --proxy-type http

⚙️ MCP 客户端配置

Claude Desktop 配置（最常用）

配置文件位置:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

基础配置（无代理）

{
  "mcpServers": {
    "dm8": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-dm8-server",
        "--host", "127.0.0.1",
        "--port", "5236",
        "--username", "SYSDBA",
        "--password", "your_password",
        "--schema", "SYSDBA"
      ]
    }
  }
}

代理配置（企业环境）

{
  "mcpServers": {
    "dm8": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-dm8-server",
        "--host", "your_dm_host",
        "--username", "SYSDBA",
        "--password", "your_password",
        "--schema", "SYSDBA",
        "--proxy-enabled",
        "--proxy-host", "proxy.company.com",
        "--proxy-port", "8080",
        "--proxy-type", "http"
      ]
    }
  }
}

环境变量配置（更安全）

{
  "mcpServers": {
    "dm8": {
      "command": "npx",
      "args": ["-y", "mcp-dm8-server"],
      "env": {
        "DM_USERNAME": "SYSDBA",
        "DM_PASSWORD": "your_password",
        "DM_HOST": "your_dm_host",
        "DM_PORT": "5236",
        "DM_SCHEMA": "SYSDBA",
        "DM_DB_PROXY_ENABLED": "true",
        "DM_DB_PROXY_HOST": "proxy.company.com",
        "DM_DB_PROXY_PORT": "8080",
        "DM_DB_PROXY_TYPE": "http",
        "NODE_OPTIONS": "--openssl-legacy-provider"
      }
    }
  }
}

其他 MCP 客户端配置

Cline (VSCode Extension)

在 VSCode Settings → Cline → MCP Settings 中配置：

{
  "mcpServers": {
    "dm8": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-dm8-server",
        "--host", "127.0.0.1",
        "--port", "5236",
        "--username", "SYSDBA",
        "--password", "your_password",
        "--schema", "SYSDBA"
      ]
    }
  }
}

mcp-router 配置

在 ~/.mcp-router/config.json 中配置：

{
  "servers": {
    "dm8": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-dm8-server",
        "--host", "127.0.0.1",
        "--port", "5236",
        "--username", "SYSDBA",
        "--password", "your_password",
        "--schema", "SYSDBA"
      ],
      "env": {
        "NODE_OPTIONS": "--openssl-legacy-provider"
      }
    }
  }
}

🌐 代理支持详情

支持的代理类型

HTTP: 标准 HTTP 代理
HTTPS: HTTPS 代理
SOCKS4: SOCKS4 代理
SOCKS5: SOCKS5 代理

配置参数

CLI 参数	环境变量	说明	默认值
`--proxy-enabled`	`DM_DB_PROXY_ENABLED`	启用代理	false
`--proxy-host`	`DM_DB_PROXY_HOST`	代理主机	无
`--proxy-port`	`DM_DB_PROXY_PORT`	代理端口	无
`--proxy-type`	`DM_DB_PROXY_TYPE`	代理类型	http

环境变量配置示例

export DM_DB_PROXY_ENABLED="true"
export DM_DB_PROXY_HOST="proxy.company.com"
export DM_DB_PROXY_PORT="8080"
export DM_DB_PROXY_TYPE="http"

npx mcp-dm8-server --username SYSDBA --password 密码 --host your_dm_host --schema SYSDBA

🛠️ 可用工具

工具名	描述	参数
`list_tables`	列出指定 Schema 的所有表	`schema` (可选)
`describe_table`	显示表结构信息	`schema` (可选), `table` (必填)
`execute_query`	执行只读 SQL 查询	`schema` (可选), `query` (必填)

⚠️ 安全限制: 只允许执行 SELECT/SHOW/DESCRIBE/EXPLAIN 语句

📋 命令行参数

参数	环境变量	必填	默认值	说明
`--host`	`DM_HOST`	✅	无	数据库主机地址
`--port`	`DM_PORT`	❌	5236	数据库端口
`--username`	`DM_USERNAME`	✅	无	数据库用户名
`--password`	`DM_PASSWORD`	✅	无	数据库密码
`--schema`	`DM_SCHEMA`	✅	无	默认数据库模式
`--proxy-enabled`	`DM_DB_PROXY_ENABLED`	❌	false	启用代理连接
`--proxy-host`	`DM_DB_PROXY_HOST`	❌	无	代理服务器地址
`--proxy-port`	`DM_DB_PROXY_PORT`	❌	无	代理服务器端口
`--proxy-type`	`DM_DB_PROXY_TYPE`	❌	http	代理类型

🔧 开发与本地构建

# 克隆项目
git clone https://github.com/lianekai/mcp-dm8-server.git
cd mcp-dm8-server

# 安装依赖
npm install

# 开发模式
npm run dev

# 构建
npm run build

# 本地测试
npm test

# 本地运行
node dist/index.js --host 127.0.0.1 --port 5236 --username SYSDBA --password 密码 --schema SYSDBA

📌 注意事项

Node.js 版本要求

Node.js 16.x: 直接使用
Node.js 18.x+: 需要添加 --openssl-legacy-provider 参数

# Node.js 18+ 使用方式
NODE_OPTIONS=--openssl-legacy-provider npx mcp-dm8-server --host 127.0.0.1 --username SYSDBA --password 密码 --schema SYSDBA

安全最佳实践

密码安全: 建议使用环境变量存储敏感信息
网络安全: 在企业环境中使用代理连接
权限控制: 使用只读数据库用户
审计日志: 启用数据库审计功能

🛡️ 安全特性

✅ SQL 注入防护
✅ 连接池管理
✅ 只读查询强制
✅ 输入验证和超时控制
✅ 结构化日志记录

❓ 常见问题

Q: Node.js 18+ 启动失败？ 使用 NODE_OPTIONS=--openssl-legacy-provider 参数

Q: 代理连接失败？

检查代理服务器状态
验证代理地址和端口
确认网络连接通畅

Q: 如何在 Claude Desktop 中使用？ 将配置添加到 claude_desktop_config.json 文件中

Q: 支持哪些数据库操作？ 仅支持只读操作：SELECT、SHOW、DESCRIBE、EXPLAIN

📄 许可证

ISC License

维护状态: 生产就绪，活跃维护 npm 包: mcp-dm8-server GitHub: lianekai/mcp-dm8-server

DM8 (Dameng Database)