MCP 服务器使用

客户端配置

Cursor 配置（推荐 STDIO）

编辑 ~/.cursor/mcp.json 或项目级 MCP 配置：

{\n  "mcpServers": {\n    "puax": {\n      "command": "npx",\n      "args": ["puax-mcp-server", "--stdio"]\n    }\n  }\n}

Claude Desktop / HTTP 模式

{\n  "mcpServers": {\n    "puax": {\n      "type": "streamable-http",\n      "url": "http://127.0.0.1:2333/mcp"\n    }\n  }\n}

工具分类速查（v3.10）

类别	代表工具
角色 / SKILL	`list_skills` `get_skill` `activate_skill` `get_role_with_methodology`
检测与推荐	`puax_detect_trigger` `puax_quick_detect` `recommend_role` `activate_with_context`
行为协议	`puax_check_diagnosis` `puax_confidence_check` `puax_switch_on_failure` `puax_verify_completion`
会话 / 压力	`puax_start_session` `puax_get_pressure_level` `puax_handle_breakthrough`
自进化	`puax_get_evolution_baseline` `puax_record_evolution`
自定义角色	`puax_register_custom_role` `puax_list_custom_roles`
可观测	`puax_get_usage_stats` `puax_flush_telemetry`
编排 / 平台	`puax_orchestrate_team` `puax_list_platforms`

代码示例

# 最简单路径：一条龙激活
activate_with_context(
  context="用户说：为什么还是不行？已经试了三遍",
  autoActivate=true
)
# → 检测触发 → 推荐角色 → 注入含 [PUAX-DIAGNOSIS] 的 System Prompt

# 会话模式
puax_start_session(session_id="sess-1")
puax_detect_trigger(session_id="sess-1", event_type="UserPromptSubmit", ...)
puax_get_pressure_level(session_id="sess-1")
puax_end_session(session_id="sess-1")

上一课

下一课