@szc-ft/mcp-szcd-client

szcd 组件库 MCP 客户端 — 自动配置 AI 编码工具的 MCP 服务器连接、Skills、Agents 和 Commands。

安装

Windows 用户（推荐）

不需要手动安装 Node.js / npm，下载并双击安装器：

https://mcp.szcd-mcp.top/download?path=/scity/zengzhijie/mcp/downloads/SZCD-MCP-Setup.exe&key=3f4ec52f5137dbf2b458d87a28a3948ea88149b1d506e106

安装器会自动检查/安装 Node.js LTS，然后执行客户端安装与 IDE 配置。安装完成后请重启已打开的 IDE。

开发者 / 已安装 Node.js 的用户

npm install -g @szc-ft/mcp-szcd-client

安装后自动执行配置，支持以下 AI 编码工具：

| 工具 | 配置方式 | |------|---------| | Claude Code | ~/.claude.json + ~/.claude/agents/ + ~/.claude/skills/ | | Trae CLI | ~/.traecli/trae_cli.yaml | | Trae IDE | ~/.trae-cn/mcp.json + ~/.trae-cn/agents/ | | Qoder CLI | ~/.qoder/settings.json + ~/.qoder/agents/ + ~/.qoder/skills/ | | Qwen Code | ~/.qwen/extensions/szcd-component-helper/（扩展机制） |

连接方式

方式1: 本地直连 (stdio)

无需远程服务器，每次启动时本地运行 MCP 服务器进程：

{
  "mcpServers": {
    "szcd-component-helper": {
      "command": "npx",
      "args": ["szcd-mcp-server", "--stdio"]
    }
  }
}

方式2: Streamable HTTP 远程连接（推荐）

连接到远程运行的 MCP 服务器，多客户端共享：

{
  "mcpServers": {
    "szcd-component-helper": {
      "type": "http",
      "url": "http://localhost:3456/mcp"
    }
  }
}

方式3: SSE 远程连接（旧客户端向后兼容）

{
  "mcpServers": {
    "szcd-component-helper": {
      "type": "sse",
      "url": "http://localhost:3456/sse"
    }
  }
}

CLI 命令

| 命令 | 功能 | |------|------| | szcd-mcp-setup | 运行安装配置（同 npm run setup） | | szcd-mcp-update-url [url] | 更新 MCP 服务器地址并同步所有 IDE 配置 | | szcd-mcp-coding-config | 配置 CODING 平台连接信息 |

智能体（Agent）

提供 szcd-component-expert 智能体，帮助开发者查询组件信息、匹配需求到组件、生成基于 szcd 组件库的 React 代码。

各工具自动获取对应详细度的版本：

| 工具 | Agent 版本 | 特点 | |------|-----------|------| | Claude Code / Qwen | base | 基础工作流，无工具名前缀 | | Trae | enhanced | 增强工作流，mcp__szcd-component-helper__ 工具名前缀 | | Qoder | full | 完整工作流 + MCP 工具表 + AskUserQuestion 交互 |

Agent 构建

Agent 配置采用单一源模板 + 条件标记 + 构建脚本的方案：

npm run build:agents

修改 agents/src/ 下的模板后运行构建，自动生成各平台适配文件。

Skill

提供 szcd-component-helper Skill，包含 22 个 MCP 工具的使用说明。

项目结构

├── agents/
│   ├── src/                        # 源模板（唯一编辑入口）
│   │   ├── szcd-component-expert.md
│   │   └── tools.json
│   ├── platforms.json              # 平台适配配置
│   ├── build.js                    # 构建脚本
│   ├── szcd-component-expert.md    # [生成] Claude / Qwen
│   ├── szcd-component-expert.trae.md # [生成] Trae
│   └── szcd-component-expert.qoder.md # [生成] Qoder
├── commands/                       # 自定义命令
├── skill/                          # Skill 定义
├── qwen-extension/                 # Qwen Code 扩展包
├── scripts/
│   ├── postinstall.js              # 安装入口
│   ├── update-mcp-url.js           # URL 同步工具
│   ├── update-coding-config.js     # CODING 配置工具
│   └── lib/                        # 各平台适配模块
│       ├── claude-code.js
│       ├── trae-cli.js
│       ├── trae-ide.js
│       ├── qoder.js
│       ├── qwen-code.js
│       └── opencode.js
└── AGENTS.md                       # 项目级指令

配置文件

MCP 服务器地址保存在 ~/.szcd-mcp-config.json：

{
  "MCP_SERVER_URL": "http://localhost:3456",
  "MCP_SERVER_NAME": "szcd-component-helper",
  "MCP_TIMEOUT": 30000
}

License

MIT