mdm-mcp

DEM MDM 的 MCP 服务：12 个 MCP Tools 直连 MDM 后端 API，供 Cursor / Agent 调用。

mdm-worker 为遗留 REST 封装，本 MCP 项目不依赖它。

安装与构建

cd mdm-mcp
npm install
npm run build
npm test

环境变量

变量	必填	说明
MDM_ACCOUNT	是	MDM 账号
MDM_PWD	是	已加密密文
MDM_API_BASE_URL	否	MDM 后端地址，默认 http://47.92.222.148:30038
MDM_TENANT_ID	否	租户 ID，默认 779760045352058880
MDM_TOKEN	否	已有 demdmtoken 时可配置，跳过登录
MDM_MCP_PORT	否	HTTP 模式端口，默认 3100

运行模式

stdio（默认，供 Cursor 使用）

npm start

HTTP（Streamable HTTP，供远程客户端）

npm run start:http

服务地址：http://localhost:3100/mcp

HTTP 鉴权（Token 优先）

全部 12 个工具统一支持 Token 优先鉴权，优先级如下：

1. 请求头 token 或 demdmtoken
2. 工具参数 token（未在 schema 暴露，保留兼容）
3. 环境变量 MDM_TOKEN
4. 环境变量 MDM_ACCOUNT + MDM_PWD（登录获取 token）

典型用法：先调用 mdm_app_menu 获取 token，后续 HTTP 请求在 Header 中携带同一 token，跳过重复登录：

curl -X POST http://localhost:3100/mcp \
  -H "Content-Type: application/json" \
  -H "token: <demdmtoken>" \
  -H "mcp-session-id: <session-id>" \
  -d '{ ... }'

stdio 模式（Cursor）无 HTTP 请求头，可使用 MDM_TOKEN 环境变量，或由 mdm_app_menu 返回的 token 通过上述回退链自动登录。

Cursor 配置

在 Cursor 的 MCP 设置（mcp.json）中添加：

{
  "mcpServers": {
    "mdm": {
      "command": "node",
      "args": ["D:/cloudflare/mdm-mcp-poc/mdm-mcp/dist/index.js"],
      "env": {
        "MDM_API_BASE_URL": "http://47.92.222.148:30038",
        "MDM_TENANT_ID": "779760045352058880",
        "MDM_ACCOUNT": "<your-account>",
        "MDM_PWD": "<encrypted-pwd>"
      }
    }
  }
}

请将 args 路径改为你本机实际路径。

MCP 工具列表（12 个）

Tool	说明
mdm_app_menu	应用菜单树
mdm_form_list	按菜单名查表单列表（带标签）
mdm_form_detail	表单详情（带标签）
mdm_form_data	表单原始数据
mdm_child_table_data	子表数据
mdm_form_config_status	表单配置与状态
mdm_form_config_components	表单组件配置
mdm_query_custom_tree_father	自定义树父节点
mdm_query_field_page	关联字段分页
mdm_save_or_update_form_data	新增/编辑表单
mdm_query_form_and_function	菜单表单与功能
mdm_position_personnel	岗位人员查询

项目结构

src/
  services/     # MDM API 业务逻辑（自 mdm-worker 复制）
  tools/        # MCP tool 定义与执行
  auth.ts       # 鉴权（account/pwd 或 token）
  config.ts     # 环境变量
  index.ts      # 入口（stdio / HTTP）

开发

npm run dev        # stdio 调试
npm run dev:http   # HTTP 调试