You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 

3.4 KiB

达梦数据库 MCP 服务 - 实施说明

一、架构说明

MCP 服务通过 stdio(标准输入/输出)与客户端通信。当前实现不支持直接网络访问,客户端需要在本地执行服务程序。

使用模式

模式 说明 适用场景
本地模式 客户端直接运行 dm-mcp-server 开发/单机使用

二、本地部署(Cursor 直接运行)

2.1 打包获取可执行文件

# 打包
./build.sh

# 解压获取可执行文件
tar -xzf dist/go-markdown_*_linux_amd64.tar.gz -C /tmp/
mv /tmp/dm-mcp-server /usr/local/bin/
chmod +x /usr/local/bin/dm-mcp-server

2.1.2 Windows 平台

  1. 打包 Windows 版本

    # 在 Linux/Mac 上交叉编译
    GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -o dm-mcp-server.exe .
    

    或修改 .goreleaser.yaml 取消 windows 行注释后重新打包。

  2. 放置可执行文件

    • dm-mcp-server.exe 放到任意目录,如 D:\app\dm-mcp-server\
    • 将该目录添加到系统 PATH 环境变量:
      • 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
      • 在「系统变量」中找到 Path,双击编辑
      • 添加 D:\app\dm-mcp-server\
    • 或使用绝对路径配置 Cursor(见下节)
  3. 验证安装

    dm-mcp-server.exe --version
    

2.2 Cursor 客户端配置

编辑 Cursor 配置文件:

Linux/macOS: ~/.cursor/mcp.json Windows: %USERPROFILE%\.cursor\mcp.json

绝对路径配置示例(推荐):

{
  "mcpServers": {
    "dm-mcp-server": {
      "command": "/home/Viviman/Music/app/mcp/dm-mcp-server",
      "env": {
        "DM_HOST": "数据库地址",
        "DM_PORT": "5236",
        "DM_USERNAME": "账号",
        "DM_PASSWORD": "密码",
        "DM_SCHEMA": "模式名"
      }
    }
  }
}

Windows 绝对路径示例

{
  "mcpServers": {
    "dm": {
      "command": "D:\\app\\dm-mcp-server\\dm-mcp-server.exe",
      "env": {
        "DM_HOST": "localhost",
        "DM_PORT": "5236",
        "DM_USERNAME": "SYSDBA",
        "DM_PASSWORD": "密码",
        "DM_SCHEMA": "MAIN"
      }
    }
  }
}

三、常见问题

Q1: Cursor 找不到 dm-mcp-server 命令

确保可执行文件在 PATH 中,或使用绝对路径:

{
  "mcpServers": {
    "dm-mcp-server": {
      "command": "C:\\app\\dm-mcp-server\\dm-mcp-server.exe",
      "env": {
        "DM_HOST": "localhost",
        "DM_PORT": "5236",
        "DM_USERNAME": "SYSDBA",
        "DM_PASSWORD": "密码",
        "DM_SCHEMA": "MAIN"
      }
    }
  }
}

Windows 配置示例%USERPROFILE%\.cursor\mcp.json):

{
  "mcpServers": {
    "dm": {
      "command": "D:\\app\\dm-mcp-server\\dm-mcp-server.exe",
      "env": {
        "DM_HOST": "localhost",
        "DM_PORT": "5236",
        "DM_USERNAME": "SYSDBA",
        "DM_PASSWORD": "your_password",
        "DM_SCHEMA": "MAIN"
      }
    }
  }
}

四、命令行参数

参数 环境变量 说明 默认值
-host DM_HOST 数据库主机 -
-port DM_PORT 端口 5236
-username DM_USERNAME 用户名 -
-password DM_PASSWORD 密码 -
-schema DM_SCHEMA 模式名 -
-version - 显示版本 -