MCP Server for Dameng DM8

达梦数据库 DM8 的 MCP (Model Context Protocol) 服务器实现，为 AI 助手提供数据库查询和结构发现能力。

功能特性

| 类型 | 名称 | 功能 | |----------|-------------------|-------------------------| | Tool | dm_query | 执行只读 SQL 查询（支持行数限制） | | Tool | dm_list_tables | 列出所有表（支持包含视图） | | Tool | dm_describe_table | 查看表完整结构（列/主键/索引/外键） | | Tool | dm_sample_data | 查看表前 N 行数据样本 | | Resource | schema://tables | 自动发现所有表和视图 | | Resource | table://{name} | 自动发现单个表结构 |

配置

.mcp.json 文件

在项目根目录创建 .mcp.json 文件：

{
	"mcpServers":{
		"dameng":{
			"command":"npx",
			"args":[
				"-y",
				"mcp-server-dm8"
			],
			"env":{
				"DM_HOST":"192.168.1.19",
				"DM_PORT":"5237",
				"DM_USER":"DATA_SMP_USER",
				"DM_PASSWORD":"your_password",
				"DM_SCHEMA":"DATA_SMP_USER"
			}
		}
	}
}

环境变量

| 变量 | 说明 | 默认值 | 必填 | |-------------|---------|-----------|-------| | DM_HOST | 达梦数据库地址 | localhost | 否 | | DM_PORT | 达梦数据库端口 | 5237 | 否 | | DM_USER | 数据库用户名 | SYSDBA | 否 | | DM_PASSWORD | 数据库密码 | - | 是 | | DM_SCHEMA | 数据库模式 | DM_USER | 否 |

工具说明

dm_query

执行只读 SQL 查询。

参数：

• sql - SQL 语句（仅支持 SELECT/SHOW/DESC/DESCRIBE/EXPLAIN/WITH）
• max_rows - 最大返回行数（默认 1000，超出自动截断）

返回： rowCount、totalRowCount、isTruncated、fields、rows

dm_list_tables

列出所有表。

参数：

• include_views - 是否包含视图（默认 false）

返回： totalCount、tables [{name, type, comments}]

dm_describe_table

查看表完整结构。

参数： table_name - 表名（字母/数字/下划线/横线）

返回： tableName、tableComments、columns、primaryKeys、indexes、foreignKeys

dm_sample_data

查看表数据样本。

参数：

• table_name - 表名
• limit - 行数（1-1000，默认 10）

返回： tableName、rowCount、fields、rows

Resource（自动发现）

AI 可以自动读取以下资源，无需显式调用工具：

• schema://tables — 获取所有表和视图的完整列表
• table://表名 — 获取单个表的完整结构（含外键关系）

安全特性

• SQL 注入防护 - 表名正则验证 + 危险关键字拦截
• 只读限制 - 仅允许 SELECT/SHOW/DESC/EXPLAIN/WITH
• 多语句防护 - 禁止包含分号（;）
• 行数限制 - dm_query 和 dm_sample_data 最大 1000 行
• 密码校验 - 启动时强制检查 DM_PASSWORD
• 连接池管理 - 自动释放连接