MCP 与 CLI

从源码 workspace 启动本地 stdio MCP，查询确切版本的组件、Token 与示例。

本地 stdio 工具

MCP 运行在本机 Node 进程中，以只读工具返回真实契约、Token、示例与安装计划。GitHub Pages 托管静态资料，不提供远程 /api/mcp 服务。

corepack pnpm --filter @cwa-design/registry run build
corepack pnpm run registry:build
corepack pnpm --filter @cwa-design/mcp run build
node packages/mcp/dist/index.js

标准输入输出供 MCP 宿主使用，终端直接启动会等待协议消息。

宿主配置示例

将下面路径替换为你的真实源码绝对路径，并按宿主 MCP 设置添加。此格式说明启动方式，不代表所有宿主已验证。

{
  "mcpServers": {
    "cwa-design": {
      "command": "node",
      "args": [
        "/absolute/path/to/cwa-design/packages/mcp/dist/index.js"
      ]
    }
  }
}

按版本查询

先调用 capabilities，读取可用框架与确切版本，再查询组件。缺少版本会明确报错，不会默默换成最新版。

{
  "tool": "cwa_design_get_component",
  "arguments": {
    "framework": "react",
    "version": "0.1.0-alpha.4",
    "componentId": "surface",
    "sections": [
      "api"
    ],
    "part": "root"
  }
}

cwa_design_get_capabilitiescwa_design_search_componentscwa_design_get_componentcwa_design_get_examplecwa_design_get_tokenscwa_design_get_recipecwa_design_plan_installationcwa_design_get_migration

大型组件按 sections 与 part 查询，例如 SelectContent。示例、Token 与配方按 nextCursor 继续读取；源码按 sourcePage.offset（Unicode 字符）拼接，并用 artifact.contentDigest 校验完整文件。完整 MCP 响应上限 12 KiB，历史版本缺少产物会明确返回 REGISTRY_UNAVAILABLE。

没有 MCP 也能查询

corepack pnpm --filter @cwa-design/cli run build
node packages/cli/dist/index.js inspect surface --version=0.1.0-alpha.4 --json
node packages/cli/dist/index.js plan button input --version=0.1.0-alpha.4 --json

CLI 默认只输出可审查的计划，写入型命令需要显式请求。安装计划不会假定未发布 npm 包已经可用。