@zat-design/sisyphus-react-mcp 4.5.7 → 4.5.8-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,48 +1,49 @@
1
1
  # @zat-design/sisyphus-react-mcp
2
2
 
3
- ## 解决什么问题
3
+ ## 用途
4
4
 
5
- 向 AI 暴露 Sisyphus 真实的组件清单、API、TypeScript 类型和 demo,避免凭记忆生成过时代码。元数据随 MCP 发布,业务组件包不再携带 AI 快照。
5
+ Sisyphus MCP 向 AI 暴露真实的组件清单、API、TypeScript 类型和 demo。只查组件用法时单独使用 MCP;需要从截图或需求生成保险业务页骨架时,配合 Scene Agent 使用。
6
6
 
7
- ## 前置版本
7
+ ## 安装与版本
8
8
 
9
- - Node.js 18+
10
- - `@zat-design/sisyphus-react@4.5.7`
11
- - `@zat-design/sisyphus-react-mcp@4.5.7`
9
+ 需要 Node.js 18+。新项目默认安装 npm `latest` 稳定版:
12
10
 
13
- 两包必须完全同版。启动时校验项目组件版本、MCP 内置元数据版本、schema v2 和 SHA-256。
14
-
15
- ## 三步安装
11
+ ```bash
12
+ npm install @zat-design/sisyphus-react
13
+ ```
16
14
 
17
- 1. 安装同版组件库。
18
- 2. 在 `.mcp.json` 或 `.cursor/mcp.json` 配置:
15
+ 在 Claude Code `.mcp.json` 或 Cursor `.cursor/mcp.json` 中配置:
19
16
 
20
17
  ```json
21
18
  {
22
19
  "mcpServers": {
23
20
  "sisyphus-react": {
24
21
  "command": "npx",
25
- "args": ["-y", "@zat-design/sisyphus-react-mcp@4.5.7"]
22
+ "args": ["-y", "@zat-design/sisyphus-react-mcp"]
26
23
  }
27
24
  }
28
25
  }
29
26
  ```
30
27
 
31
- 3. 重启 AI 工具并调用 `sisyphus-get-meta-status`。
28
+ 锁版或 beta 项目将组件库、MCP Scene 均设为 `@<完整版本>`,三包必须完全同版。MCP 启动时会校验版本、schema v2 和 SHA-256。
32
29
 
33
- ## 推荐调用顺序
30
+ ## MCP 工具
34
31
 
35
- 1. `sisyphus-get-meta-status`
36
- 2. `sisyphus-list-components`
37
- 3. `sisyphus-get-component-api`
38
- 4. 按需 `sisyphus-get-type`
39
- 5. `sisyphus-list-examples`
40
- 6. `sisyphus-get-example`
32
+ | MCP 工具 | 用途 |
33
+ | ---------------------------- | ----------------------------- |
34
+ | `sisyphus-get-meta-status` | 验证版本、schema 和元数据 |
35
+ | `sisyphus-search` | 将业务语言映射到候选组件/能力 |
36
+ | `sisyphus-list-components` | 确认候选组件存在 |
37
+ | `sisyphus-get-component-api` | 获取候选组件的真实 API |
38
+ | `sisyphus-get-type` | 核对公开 TypeScript 类型 |
39
+ | `sisyphus-list-examples` | 按组件和场景词筛选 demo ID |
40
+ | `sisyphus-get-example` | 获取选中的单个 demo 源码 |
41
+ | `sisyphus-get-examples` | 仅供旧工作流兼容 |
41
42
 
42
- `sisyphus-search` 用于跨元数据检索;`sisyphus-get-examples` 仅作兼容。
43
+ ## 推荐顺序
43
44
 
44
- ## 常见错误
45
-
46
- - 版本不同:将组件库、MCP Scene Agent 统一到完全相同的 SemVer。
47
- - 找不到组件包:确认当前业务项目安装了同版 `@zat-design/sisyphus-react`。
48
- - schema/哈希错误:重新安装同版 MCP,不继续使用损坏缓存。
45
+ 1. `sisyphus-get-meta-status`
46
+ 2. 按需 `sisyphus-search`,再用 `sisyphus-list-components` 确认候选组件。
47
+ 3. 编码前调用 `sisyphus-get-component-api`,按需补查 `sisyphus-get-type`。
48
+ 4. `sisyphus-list-examples`,再 `sisyphus-get-example`。
49
+ 5. 只使用已验证 API 编码并运行项目校验。
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 2,
3
- "version": "4.5.7",
3
+ "version": "4.5.8-beta.1",
4
4
  "components": [
5
5
  {
6
6
  "name": "ProCollapse",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 2,
3
- "version": "4.5.7",
3
+ "version": "4.5.8-beta.1",
4
4
  "examples": [
5
5
  {
6
6
  "id": "ProCollapse/demos/collapse.tsx",
@@ -1,15 +1,15 @@
1
1
  {
2
2
  "schemaVersion": 2,
3
- "version": "4.5.7",
3
+ "version": "4.5.8-beta.1",
4
4
  "counts": {
5
5
  "components": 29,
6
6
  "examples": 280,
7
7
  "types": 64
8
8
  },
9
9
  "files": {
10
- "components.json": "14ad936b35f4b463c1a0b48242bd7ad89809f697ec11b4ee5c1cd5c4a06e153c",
11
- "props.json": "3a39f4cd532fe0a558e8580a8c2817820a6a1fe19d6b6532dde5d2cc4d62f7e6",
12
- "examples.json": "75a19617707121cab1a268c8adcda80caf9339bf0d2a98409d8791b44ca6510f",
13
- "types.json": "76079ed6874c188d38effc3a86e3e7d1a7083f66997f27d8e52199a69485f52b"
10
+ "components.json": "de8ecdb5288b411d3d9dc504dafb28ebccd847146e4472870e95c11a8b26c6c2",
11
+ "props.json": "23653cc71f0bd9f8dcfda3ba70ae0ae25f25c1a8d1f7bc459831034aecd20326",
12
+ "examples.json": "f196a7ad2a24d4e472a0d806d55b2728753a96be10bb6c237c3dcf25c7e1dc9b",
13
+ "types.json": "5bd7d73a6fcc2905c421565d218a45651957b4e94a9fb2f6576818c33a5ac434"
14
14
  }
15
15
  }
package/meta/props.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 2,
3
- "version": "4.5.7",
3
+ "version": "4.5.8-beta.1",
4
4
  "components": {
5
5
  "ProCollapse": {
6
6
  "source": "typescript+docs",
package/meta/types.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 2,
3
- "version": "4.5.7",
3
+ "version": "4.5.8-beta.1",
4
4
  "types": [
5
5
  {
6
6
  "name": "ProConfigProviderType",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zat-design/sisyphus-react-mcp",
3
- "version": "4.5.7",
3
+ "version": "4.5.8-beta.1",
4
4
  "description": "MCP server for @zat-design/sisyphus-react — 向 AI 编码助手暴露组件库的清单/API/示例查询能力",
5
5
  "type": "module",
6
6
  "bin": {