MCP Server for Dameng DM8

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

功能特性

配置

.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_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

• 连接池管理 - 自动释放连接