# @smwb/ui-mcp-solid 中文文档

规范地址：https://npmcn.com/package/%40smwb/ui-mcp-solid/

版本：2\.9\.2
npm 元数据更新时间：2026-11-02T12:25:25.652Z
中文译文更新时间：2026-11-02T12:28:27.026Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40smwb/ui-mcp-solid
原文对照：https://npmcn.com/package/%40smwb/ui-mcp-solid/?lang=original
项目主页：https://sourcecraft.dev/elfenmail/ui
源码仓库：https://git.sourcecraft.dev/elfenmail/ui

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：488 kB，162 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2026-05-29T12:52:57.779Z
- 最新版本发布：2026-11-02T12:25:25.390Z
- 已发布版本数：36（近 12 个月 36 个）

## 中文简介

模型上下文协议服务器公开了@smwb/ui-solid （SolidJS）组件目录和定制指南。

## 安装

```sh
npm install @smwb/ui-mcp-solid
```

也可以使用：`pnpm add @smwb/ui-mcp-solid`、`yarn add @smwb/ui-mcp-solid`、`bun add @smwb/ui-mcp-solid`

## README

# @smwb / ui-mcp-solid

一、 [模型上下文协议](https://modelcontextprotocol.io/) (MCP) **它的服务器** 这就暴露了 [`@smwb/ui-solid`](https://www.npmjs.com/package/@smwb/ui-solid) 组件目录和定制 AI编码助手指南（Cursor, Claude Desktop/Code, Copilot，…）。

![license](https://img.shields.io/badge/license-MIT-blue.svg)

## 工具

| 工具 | 目的 |
| --- | --- |
| `search_components` | 通过名称、id、描述或prop关键字查找组件 |
| `get_component_props` | 一个组件的完整元数据：道具（类型、要求、描述）、SSR分类(`ssr.safe` / `ssr.rendering` / `ssr.note`) +所需进口较少(`styles.base` / `styles.entries` / `styles.dependencies` / `styles.importExample`） |
| `search_customization` | 全局主题化选项和每个组件定制方法 |
| `get_customization` | 什么以及如何自定义组件或全局主题 |

## 运行

```sh
npx -y @smwb/ui-mcp-solid
```

沟通在 **的头** 只有（没有HTTP端口）；启动日志到stderr。

### 光标(`.cursor/mcp.json`) / Claude Desktop配置

```json
{
  "mcpServers": {
    "smwb-ui-solid": {
      "command": "npx",
      "args": ["-y", "@smwb/ui-mcp-solid"]
    }
  }
}
```

## 示例流

1.  `search_components` → `{ "query": "text field", "limit": 5 }`
2.  `get_component_props` → `{ "nameOrId": "TextField" }` (或id `inputs/textField/textField`) - - - 读 `styles.entries` / `styles.dependencies` / `styles.importExample` 一个最小的LESS bundle
3.  `get_customization` → `{ "nameOrId": "Button" }` 或者 `{ "nameOrId": "global/runtime-css" }`

组件id遵循元数据路径，例如： `dataDisplay/chat/chat`.

## 苏维埃社会主义共和国

每个组件都有一个 `ssr` 领域（也浮出水面） `search_components` 结果):

-   `safe` ——永远 `true`：没有 `@smwb/ui-solid` 在模块加载或加载时触摸浏览器全局 在渲染过程中 `renderToString` 从来没有抛出。
-   `rendering` - - - - - - `"universal"` （在服务器上发出有意义的静态HTML并进行组合）或 `"client"` (一个纯粹的覆盖，如 `Modal`/`Sheet` 这将在服务器上不呈现任何内容并进行挂载 通过水合作用后的入口)。
-   `note` -可选提示，例如，选择器的输入呈现在服务器上，而它的弹出窗口是 仅客户端的。

## 目录是如何构建的

组件元数据从 `@smwb/ui-solid` TypeScript prop接口 （`npm run build:meta`)，并装在这个包裹下运送 `component-meta/`。更少的导入提示 参考 [`@smwb/ui-styles`](https://www.npmjs.com/package/@smwb/ui-styles).

## 许可证

[麻省理工学院](https://npmcn.com/package/%40smwb/ui-mcp-solid/LICENSE)

## 常见问题

### @smwb/ui-mcp-solid 是什么？

模型上下文协议服务器公开了@smwb/ui-solid （SolidJS）组件目录和定制指南。

### 如何安装 @smwb/ui-mcp-solid？

在项目目录运行 npm install @smwb/ui-mcp-solid，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ui-mcp-solid，可以用 npx ui-mcp-solid 直接运行。

### @smwb/ui-mcp-solid 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/smwb\_\_ui-mcp-solid 是否存在。

### @smwb/ui-mcp-solid 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @smwb/ui-mcp-solid 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @smwb/ui-mcp-solid 可以商用吗？

@smwb/ui-mcp-solid 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @smwb/ui-mcp-solid 还在维护吗？

最新版本 2\.9\.2 发布于 2026/11/02（1 天前）；至今共发布 36 个版本，其中过去 12 个月发布了 36 个；首次发布于 2026/05/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。