内容
# @stampui/mcp
[](https://www.npmjs.com/package/@stampui/mcp)
[](https://github.com/StampUI/mcp/actions/workflows/ci.yml)
[](./LICENSE)
MCP（模型上下文协议）服务器，用于 [StampUI](https://stampui.com)。允许 AI 编码代理浏览 StampUI 区块注册表，并将区块作为实际的 `.tsx` 源文件安装到项目中，而无需离开编辑器：“添加一个 FAQ 部分”变成搜索、检查、安装。
## 工具
| 工具 | 功能 |
|------|--------------|
| `list_blocks` | 列出区块，按 `category`、`tier`（`free`/`pro`）或 `framework` 过滤 |
| `search_blocks` | 在 slug、标题、描述、标签中进行自由文本搜索 |
| `get_block` | 完整的清单、安装命令、文档链接和源代码（免费区块）或解锁说明（专业区块） |
| `stamp_block` | 将区块的文件写入项目中的绝对 `targetDir` |
注册表数据和免费区块源来自 MIT [`@stampui/blocks`](https://www.npmjs.com/package/@stampui/blocks) 包；清单格式在开放的 [区块清单规范](https://github.com/StampUI/ui/blob/main/docs/block-manifest.md) 中有文档。
## 设置
### Claude 代码
```bash
claude mcp add stampui -- npx -y @stampui/mcp
```
### Claude 桌面版
将以下内容添加到 `claude_desktop_config.json`（设置 > 开发者 > 编辑配置）：
```json
{
"mcpServers": {
"stampui": {
"command": "npx",
"args": ["-y", "@stampui/mcp"]
}
}
}
```
### Cursor 和其他 MCP 客户端
将相同的条目添加到客户端的 MCP 配置中（例如 `~/.cursor/mcp.json`）：
```json
{
"mcpServers": {
"stampui": {
"command": "npx",
"args": ["-y", "@stampui/mcp"]
}
}
}
```
## 免费与专业
**免费区块** 所需的一切都**离线且无需账号即可工作**：源代码包含在 `@stampui/blocks` 中。
**专业区块** 是 StampUI 商业目录的一部分。它们的源代码不包含在此包或任何公共仓库中。使用许可证密钥，在服务器的环境中设置它，专业源代码将按请求从许可注册表中获取：
```bash
claude mcp add stampui --env STAMPUI_TOKEN=SU_LIVE_-XXXX -- npx -y @stampui/mcp
```
如果没有令牌，专业区块仍将出现在列表中，`get_block` 将解释如何解锁它们；服务器永远不会尝试绕过许可，添加此类行为的 PR 将被关闭。
## 环境变量
| 变量 | 含义 | 默认值 |
|----------|---------|---------|
| `STAMPUI_TOKEN` | 商业许可证密钥；仅专业区块需要 | 未设置 |
| `STAMPUI_REGISTRY_URL` | 注册表来源，用于测试 | `https://stampui.com` |
## 安全说明
- 服务器通过 stdio 在本地运行；它仅在 HTTPS 注册表中为专业区块获取进行网络请求。
- `stamp_block` 写入文件。它需要一个绝对的 `targetDir`，并拒绝在该目录之外解析的路径。请像检查其他代码一样检查代理安装的内容；MCP 客户端在调用工具之前会请求权限，默认情况下请保持此权限开启。
- 您的许可证密钥从环境中读取，仅在 `Authorization` 头中发送到注册表。切勿将其粘贴到聊天中。
- 按照 [SECURITY.md](./SECURITY.md) 报告漏洞。
## 开发
```bash
git clone https://github.com/StampUI/mcp
cd mcp
npm install
npm run build
# 使用 MCP 检查器进行测试：
npx @modelcontextprotocol/inspector node dist/index.js
```
## 链接
- StampUI：https://stampui.com
- 免费组件源代码：https://github.com/StampUI/ui
- CLI：https://github.com/StampUI/cli
- 更新日志：[CHANGELOG.md](./CHANGELOG.md)
## 许可证
本服务器的 MIT 许可证。免费区块通过 `@stampui/blocks` 以 MIT 许可证提供；专业区块受 [StampUI 商业许可证](https://stampui.com/docs/license) 约束。
