PinK MCP

把正在运行的 PinK 里那组 pink_* 工具暴露成只监听本机的 MCP。Cursor 连 http://127.0.0.1:37720/mcp，查询会进当前选中的 PinK 窗口。

PinK 自己启动的 cocos-cli MCP 端点是关着的。这个插件不走那条端点，而是在 PinK 里调用 vscode.lm.invokeTool。

能调用的范围

默认只暴露只读工具（名字里带 query 或 read），例如资源、系统、构建平台、剪贴板读取。

写入和场景工具默认不出现在列表里。要暴露它们，在 PinK 里打开 pinkMcp.exposeWrites。即便如此，确认仍绑在 PinK 本地主 Chat 上，从 Cursor 调用通常会确认失败，不会绕过确认去改工程。

多开时先调 pink_mcp_list_instances，再用 pink_mcp_use_instance 选窗口。只开一个 PinK 窗口时会自动选中。

额外提供 pink_mcp_execute_command：在选中窗口里跑白名单命令（pink.* / cocos.*，以及打开资源、Reload、预览相关命令）。不走 PinK Chat 确认，适合拉起编辑器预览；不能用来绕过 pink_assets_* / pink_scene_* 写入门禁。

场景绑定、截图、资源写入仍然需要 PinK 本地主 Chat 的 toolInvocationToken。从 Cursor / 外部 MCP 客户端直接 invokeTool 时没有这份身份，这些写入会失败。

Related MCP server: SmartCLI MCP Server

安装

npm run install-pink

脚本会把 package.json、extension.js、server.js、registry.js 拷到 ~/.pink/extensions/local.pink-mcp-0.2.0/，并写入 extensions.json。

完整退出 PinK 再打开，或在每个 PinK 窗口执行 Reload Window。只关一个窗口不会加载新插件。状态栏出现 PinK MCP、工程名和工具数量后，服务就在听端口。

接到 Cursor

PinK 要保持打开。令牌在 ~/.pink/mcp/token，权限 600，不要贴进聊天。

在 Cursor 的 mcp.json 里加上：

{
  "mcpServers": {
    "pink": {
      "url": "http://127.0.0.1:37720/mcp",
      "headers": {
        "Authorization": "Bearer <~/.pink/mcp/token 的内容>"
      }
    }
  }
}

也可以在 PinK 命令面板运行「PinK MCP: 复制 Cursor 配置」，把片段贴进已有的 mcpServers。复制结果带令牌，不要发到聊天里。

工具是 PinK 启动后才注册的。Cursor 里如果列表是空的，等状态栏数量上来，再刷新这个 MCP。

多开

每个 PinK 窗口单独听一个本机端口。第一个占用 37720（网关），其余从 37721 起往上找空位。登记写在 ~/.pink/mcp/instances.json，死掉的进程会被清掉。

Cursor 始终连 37720。网关按当前选择把 pink_* 转到对应窗口。网关窗口关掉后，另一个窗口会在几秒内接管 37720。

设置

• pinkMcp.port：网关端口，默认 37720。只绑定 127.0.0.1。

• pinkMcp.token：覆盖本机令牌。留空则使用 ~/.pink/mcp/token。

• pinkMcp.exposeWrites：默认 false。

• pinkMcp.allowInsecureNoToken：默认 false。不要开着。

• pinkMcp.stateDir：实例登记目录，留空为 ~/.pink/mcp。

改完设置，或执行「PinK MCP: 重启服务」。

开发

npm test