MCP 服务器简介

npm 包 puax-mcp-server 当前是 v4.4.4。仓库里有 50 个工具，客户端默认的 tools/list 只看到 13 个黄金动词。角色 59 个，另加你本机注册的自定义角色。

先做这两步

• 医生 — npx puax-mcp-server doctor，确认后再 --fix
• STDIO — 本地 IDE 用 --stdio；HTTP 仍是 --port 2333

MCP 在 v4 里干什么

• 心跳 — 宿主代跳 puax_tick，不必手贴长 Prompt
• 闸门 — 诊断、信心、契约、独立验证
• 梦与处境 — 卡壳时入梦，需要对手时立处境
• 角色 — 59 内置 + 自定义，推荐带 score_explanation

命令

npx puax-mcp-server doctor\nnpx puax-mcp-server doctor --fix\nnpx puax-mcp-server --stdio\nnpx puax-mcp-server --port 2333\nnpx puax-mcp-server --version\nnpx puax-mcp-server --list-platforms\nnpx puax-mcp-server --export=cursor --output=./.cursor/rules

HTTP 默认 http://127.0.0.1:2333。STDIO 没有端口。现行工作流见第 18 章和第 20 章。