0.39.0 • Published yesterdayCLI

@szc-ft/mcp-szcd-client

Licence

MIT

Version

0.39.0

Deps

Size

3.0 MB

Vulns

Weekly

Install scriptsThis package runs scripts during installation (preinstall/install/postinstall)

Summary Dependency Versions

@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