在 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

说明

参数 作用
node MCP 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"秒。

相关推荐
kfaino14 小时前
码农的AI翻身(三)你好,我叫 Embedding
后端·ai编程
冬奇Lab16 小时前
Workflow 系列(01):基础理论——三种执行模型与 Anthropic 5 种模式
人工智能·agent·工作流引擎
冬奇Lab16 小时前
每日一个开源项目(第143篇):page-agent - 纯 JS 的网页 GUI Agent,无需截图、无需插件、无需后端
前端·人工智能·agent
_山海16 小时前
OpenSpec-基于SDD规格驱动开发
ai编程·vibecoding
程序员cxuan18 小时前
虽迟但到!GPT-5.6 终于来了!
人工智能·后端·程序员
ZhengEnCi20 小时前
Q03-UI设计进阶技巧-让界面更高级的7个核心原则
人工智能
IT_陈寒20 小时前
React的这个渲染问题连官方文档都没说清楚
前端·人工智能·后端
不加辣椒1 天前
第12章 工具调用与 Agent 提示工程
人工智能
用户1693176172661 天前
前端给AI消息做日期分组与时间线
人工智能
i晟1 天前
Claude Code Harness 深度拆解:从你敲回车到模型回复,中间发生了什么
人工智能