Local MCP

本文由 GLM-5.1 驱动的 CC 基于项目源码生成。

hpmcp 是 HeroUI Pro MCP Server 的本地代理。自动缓存上游响应，离线时仍可使用。

React Pro — 图表、高级表单、导航、浮层、数据展示。

添加到 .cursor/mcp.json 或 Settings > Tools > MCP Servers：

.cursor/mcp.json

{  "mcpServers": {    "heroui-pro": {      "type": "stdio",      "command": "npx",      "args": [        "-y",        "hpmcp@latest",        "react",        "HEROUI_PERSONAL_TOKEN"      ]    }  }}

在 Settings > Tools & MCPs 中启用连接。

命令行添加：

terminal

claude mcp add -s user -t stdio heroui-pro -- npx -y hpmcp@latest react HEROUI_PERSONAL_TOKEN

或添加到 .mcp.json：

.mcp.json

{  "mcpServers": {    "heroui-pro": {      "type": "stdio",      "command": "npx",      "args": [        "-y",        "hpmcp@latest",        "react",        "HEROUI_PERSONAL_TOKEN"      ]    }  }}

重启后运行 /mcp 确认连接。

添加到 .vscode/mcp.json：

.vscode/mcp.json

{  "mcpServers": {    "heroui-pro": {      "type": "stdio",      "command": "npx",      "args": [        "-y",        "hpmcp@latest",        "react",        "HEROUI_PERSONAL_TOKEN"      ]    }  }}

打开文件并点击 Start。

添加到 .windsurf/mcp.json：

.windsurf/mcp.json

{  "mcpServers": {    "heroui-pro": {      "type": "stdio",      "command": "npx",      "args": [        "-y",        "hpmcp@latest",        "react",        "HEROUI_PERSONAL_TOKEN"      ]    }  }}

重启 Windsurf 生效。

添加到 settings.json（Cmd-,）：

settings.json

{  "mcpServers": {    "heroui-pro": {      "type": "stdio",      "command": "npx",      "args": [        "-y",        "hpmcp@latest",        "react",        "HEROUI_PERSONAL_TOKEN"      ]    }  }}

重启后检查 Agent Panel 中的绿色连接指示器。

添加到 ~/.codex/config.toml（或项目级 .codex/config.toml）：

config.toml

[mcp_servers.heroui-pro]type = "stdio"command = "npx"args = ["-y", "hpmcp@latest", "react", "HEROUI_PERSONAL_TOKEN"]

重启 Codex 后运行 /mcp 确认。

可选配置

环境变量	默认值	说明
`CACHE_TTL`	`1800`	缓存有效期（秒）

示例：自定义缓存时间

{  "type": "stdio",  "command": "npx",  "args": [    "-y",    "hpmcp@latest",    "react",    "HEROUI_PERSONAL_TOKEN"  ],  "env": {    "CACHE_TTL": "3600"  }}

清除缓存：rm -rf ~/.hpmcp/cache

特性

零配置 — 上游地址内置，添加配置即可使用
自动缓存 — 响应缓存到本地，重复请求无需联网
离线可用 — 上游不可用时自动降级到缓存数据
零依赖 — 纯 Node.js，安装体积极小

2026-06-03 工具更新

上游 MCP 已从 Pro-only（4 个工具） 升级为 Pro + OSS 统一（9 个工具）。hpmcp 会自动同步，无需更新配置。

新增工具（5 个）

工具	说明
`get_component_source_code`	获取 OSS 组件的 React/TypeScript 源码（仅 `@heroui/react`，不含 Pro）
`get_chat_export_manifest`	获取 HeroUI AI Chat 导出的文件清单（commitSha、文件列表、预览 URL）
`get_chat_export_files`	根据 manifest 拉取指定的导出文件内容
`get_theme_variables`	获取主题变量和 design tokens（default、brutalism、glass、mouve）

已有工具变化

工具	旧版	新版
`list_components`	仅列 Pro 组件	Pro + OSS 统一列表（133 个）
`get_component_docs`	固定 enum，仅 Pro	自由 string 数组，Pro + OSS
`get_css`	仅 Pro，含 theme 参数	Pro + OSS，theme 参数独立到 `get_theme_variables`
`get_docs`	20 个 Pro 文档路径	大幅扩充，新增 `/pro/docs/react/...` 及更多 OSS 路径

MCP 不再区分 Pro 和 OSS 两套服务 — 一份配置即可访问所有组件的文档、源码和主题变量。如果之前单独配置过 OSS MCP，可以移除。

Local MCP

可选配置

特性

2026-06-03 工具更新

新增工具（5 个）

已有工具变化

On this page

可选配置

特性