MCP 接入 · 让 Claude / Cursor 直接驱动 CorelDRAW

① 这是什么

MCP（Model Context Protocol）是 AI 客户端连接外部工具的通用协议：Claude Desktop、Cursor、VS Code、Cherry Studio 等都支持。CdrPei 把 CorelDRAW 的能力（读文档/选区、执行全部命令、画图形、导入 SVG、撤销回滚、界面截图）封装成标准 MCP 服务，装好插件、双击一个注册脚本，你的 AI 助手就多了"一双操作 CorelDRAW 的手"。

典型用法：在 Claude 里说"看一下我当前文档，把选中的三个图形等距排列、颜色换成品牌橙"。AI 会先读取文档确认单位和尺寸，再逐条执行命令并核对结果。

MCP 工具在本机执行、连的是本机的 CorelDRAW；对话本身走你选择的 AI 客户端（Claude 等）自己的服务，与本插件无关。图纸文件不会被本插件上传。

② 前提条件

条件	说明
已安装 CdrPei 插件	到下载页安装最新版（安装包里带 MCP 服务与注册脚本）
CorelDRAW 正在运行	插件随 CDR 启动。CDR 没开时 AI 也能连上，但执行命令会提示插件离线——打开 CDR 即可
已安装 AI 客户端	Claude Desktop / Cursor / VS Code 任一；其它支持 MCP 的客户端见 ④

找不到插件目录？通常在 C:\Program Files\Corel\CorelDRAW Graphics Suite X8\Draw\Plugins64（其它版本在对应 Corel 安装目录的 Draw\Plugins64 下）。

③ 一键接入（推荐）

第 1 步　打开插件目录，双击 Register-CdrMCP.cmd

第 2 步　脚本自动识别你电脑上已装的 Claude Desktop / Cursor / VS Code，把 CdrPei MCP 写进它们的配置（改前自动备份原配置）

第 3 步　重启 AI 客户端，工具列表里出现 cdr-piemenu 即接入成功

卸载同理：运行 Register-CdrMCP.ps1 -Remove（或右键 .cmd 用 PowerShell 打开加参数），只摘除 CdrPei 自己的条目，其它配置分毫不动。

插件目录里没有 Register-CdrMCP.cmd？说明你的插件版本较旧，请先到下载页更新到最新版。

④ 手动接入（三种客户端）

不想用脚本，或用的客户端不在支持列表里？按下面的片段手工添加。把 <插件目录> 换成你的实际路径（例如 C:\Program Files\Corel\CorelDRAW Graphics Suite X8\Draw\Plugins64）。

Claude Desktop

编辑 %APPDATA%\Claude\claude_desktop_config.json，在 mcpServers 中加入：

{
  "mcpServers": {
    "cdr-piemenu": {
      "command": "<插件目录>\\python312_ocr\\pythonw.exe",
      "args": ["<插件目录>\\CdrMCPServer.pyc"]
    }
  }
}

保存后完全退出 Claude Desktop 再打开（托盘也要退出）。

Cursor

编辑 %USERPROFILE%\.cursor\mcp.json（没有就新建），写入：

{
  "mcpServers": {
    "cdr-piemenu": {
      "command": "<插件目录>\\python312_ocr\\pythonw.exe",
      "args": ["<插件目录>\\CdrMCPServer.pyc"]
    }
  }
}

或在 Cursor 设置 → MCP → Add new MCP server，按同样内容填写。

VS Code

命令面板（Ctrl+Shift+P）→ MCP: Open User Configuration，或直接编辑 %APPDATA%\Code\User\mcp.json：

{
  "servers": {
    "cdr-piemenu": {
      "type": "stdio",
      "command": "<插件目录>\\python312_ocr\\pythonw.exe",
      "args": ["<插件目录>\\CdrMCPServer.pyc"]
    }
  }
}

其它客户端（Cherry Studio、ZCode 等）：在它的 MCP 设置里选「stdio / 命令行」类型，命令填 <插件目录>\python312_ocr\pythonw.exe，参数填 <插件目录>\CdrMCPServer.pyc，效果相同。

⑤ 验证接入成功

保持 CorelDRAW 打开（建议先随便打开一张图）。
在 AI 客户端里问："用 cdr-piemenu 看一下我当前文档的状态"。AI 会调用 inspect_document 返回图层、页面尺寸、单位与选区明细。
想确认授权状态，可让它调用 license_status；想确认插件在线，可调用 ping。

如果 AI 说"工具执行超时/插件未响应"：确认 CDR 已完全启动（插件约在启动后 10 秒内就绪），然后重试一次。

⑥ 常见问题

问题	解答
客户端里看不到 cdr-piemenu 工具	① 注册脚本要重启客户端才生效；② 手动接入时检查 JSON 路径是否为你的真实插件目录；③ Claude Desktop 需从托盘完全退出再开。
工具在，但执行命令报"插件离线/超时"	CorelDRAW 没开或还在启动。打开 CDR 等 10 秒再试。CDR 关闭期间不影响聊天，只影响执行。
可以同时用多个 AI 客户端吗？	可以，互不冲突。命令按顺序在 CDR 里执行（含约 0.5 秒的执行间隔保护）。
会把我电脑上的文件/图纸上传吗？	不会。MCP 只在你本机和 CDR 通信；插件不向我们的服务器发送图纸。云端 AI 能力（文生图等）是插件内独立功能，按量计费，与本接入无关。
接入需要额外付费吗？	MCP 接入不另行收费。执行受插件原有授权等级约束（专业版命令需对应授权），AI 一看回执就知道并会提示你去激活。
需要开防火墙端口吗？	不需要。服务只监听本机回环地址（127.0.0.1），不对外网开放，且带每次启动随机生成的令牌。
能不能从另一台电脑远程连？	不能，也不建议。MCP 服务设计为"本机 AI 驱动本机 CorelDRAW"。
怎么卸载接入？	运行 `Register-CdrMCP.ps1 -Remove`（自动清理三个客户端），或手动删掉配置里 cdr-piemenu 那一项。

⑦ 安全说明

MCP 服务只绑定本机回环地址 127.0.0.1，外网无法连接；每次 CDR 启动生成一次性随机令牌，客户端自动发现。
所有命令都在你本机的 CorelDRAW 里执行，等同于你手动操作；AI 的每一步执行都会返回结果供核对，可随时用撤销回滚。
注册脚本改动配置前会自动备份（*.cdrpei.bak-时间戳），且只增删自己的条目。

遇到问题？到留言板反馈，或联系客服。

← 返回下载中心　·　了解 AI 能力 →