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
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 平台
-
打包 Windows 版本
# 在 Linux/Mac 上交叉编译 GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -o dm-mcp-server.exe .或修改
.goreleaser.yaml取消 windows 行注释后重新打包。 -
放置可执行文件
- 将
dm-mcp-server.exe放到任意目录,如D:\app\dm-mcp-server\ - 将该目录添加到系统 PATH 环境变量:
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
- 在「系统变量」中找到
Path,双击编辑 - 添加
D:\app\dm-mcp-server\
- 或使用绝对路径配置 Cursor(见下节)
- 将
-
验证安装
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 |
- | 显示版本 | - |