原创

在 Qoder CLI 集成墨刀 MCP(modao-proto)完整指南

官方的这种 npx -y @smithery/cli install @modao-mcp/modao-proto-mcp --client claude 有问题,我是直接下载仓库代码编译使用的

集成墨刀 MCP(modao-proto-mcp)到 Qoder CLI,可以让你在 Qoder 中直接调用墨刀提供的功能,实现自动化原型设计、页面生成等操作。本文将基于 Windows 系统,给出完整配置示例和注意事项。


1️⃣ 背景知识

  • MCP(Model Communication Protocol):一种标准化协议,允许客户端与各种模型/服务通过 stdioSSEHTTP 通信。
  • Qoder CLI:支持注册 MCP Server,通过 qodercli mcp add 管理 MCP。
  • 核心概念
    • command:真实存在的可执行文件(Windows 下不能带空格的复杂字符串)。
    • args:传递给可执行文件的参数列表。
    • env:环境变量传递给 MCP。
    • type:通信方式,通常使用 stdio

2️⃣ 准备工作

  1. 安装 Node.js(确保 node.exe 可在系统 PATH 中调用)。
  2. 获取墨刀 MCP 项目D:\VScodeProjects\modao-proto-mcp
  3. 获取墨刀 token(在墨刀开发者平台申请)。从墨刀AI获取你的Token(头像菜单→令牌设置)。获取Token>>
  4. 确认 MCP CLI 可以手动启动node D:\VScodeProjects\modao-proto-mcp\bin\cli.js --token <YOUR_TOKEN>
    • 若命令成功运行并没有报错,则准备工作完成。

3️⃣ Qoder CLI 添加 MCP 命令

正确示例(Windows)

# 删除已有配置(可选)
qodercli mcp remove modao-proto

# 添加墨刀 MCP
qodercli mcp add modao-proto `
    node `
    "D:\VScodeProjects\modao-proto-mcp\bin\cli.js" `
    "--token=9a98e8a94698bf26b7c166f79a0db3e6" `
    -t stdio

说明

参数作用
nodeMCP command,真实存在的可执行文件
"bin/cli.js"MCP 脚本文件路径
-e token=xxx环境变量传递 token,避免在 command 中写复杂参数
-t stdio使用 stdio 通信方式

注意:不要把 --token 拼在 command 字符串里,否则 Windows exec 会找不到文件。


4️⃣ 验证 MCP 是否成功

qodercli mcp list

成功时输出类似:

[STDIO] modao-proto: node D:\VScodeProjects\modao-proto-mcp\bin\cli.js - Connected
[STDIO] mysql: python ... - Connected
  • Connected 表示 MCP 已正常启动并可用。
  • 如果显示 Disconnected,说明 command 或路径有误,需检查 node.exe 路径和 cli.js 路径。

5️⃣ 集成后的使用方法

使用MCP

生成页面

导入到墨刀个人空间


6️⃣ Windows 下 MCP 配置注意事项

  1. command 必须是真实可执行文件
    • 不可直接写 "node bin/cli.js --token xxx"
  2. 参数拆分成 args 或环境变量
    • 推荐 token 放到环境变量,避免 command 字符串过长
  3. 工作目录
    • 如果 cli.js 使用相对路径,确保 Qoder 的 WorkingDir 指向 MCP 项目根目录
  4. 模仿 MySQL MCP 配置
    • python MCP 和 node MCP 的配置模式相同,Windows 下成功经验可类比

7️⃣ 完整 JSON 配置示例

{
  "modao-proto": {
    "command": "node",
    "env": {
      "token": ""
    },
    "args": [
      "D:\\VScodeProjects\\modao-proto-mcp\\bin\\cli.js",
      "--token=xxx"
    ],
    "type": "stdio",
    "WorkingDir": "",
    "InProcessMcpServer": null
  }
}

这个 JSON 可以直接用于 Qoder CLI 的本地配置,效果与命令行添加完全一致。


✅ 总结

  • 核心思想:Windows 下 MCP command 必须真实存在,参数用 args 或环境变量
  • 成功标志qodercli mcp list 显示 Connected
  • 墨刀 MCP 集成:完成后可在 Qoder 中直接调用墨刀工具,实现原型生成自动化

☝️小提示

因生成原型页面html需要较长时间,建议开启MCP工具的“长时间运行模式”或将超时时间设为“300”秒。

正文到此结束
Loading...