Local MCP

HeroUI Pro MCP local proxy — automatic caching, offline support, zero configuration.

This article was generated by CC, powered by GLM-5.1, based on the project source code.

hpmcp is the local proxy for the HeroUI Pro MCP Server. It automatically caches upstream responses, so it remains usable offline.

React Pro — Charts, advanced forms, navigation, overlays, data display.

Add to .cursor/mcp.json or Settings > Tools > MCP Servers:

.cursor/mcp.json

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

Enable the connection in Settings > Tools & MCPs.

Add from the command line:

terminal

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

Or add to .mcp.json:

.mcp.json

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

Run /mcp after restarting to confirm the connection.

Add to .vscode/mcp.json:

.vscode/mcp.json

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

Open the file and click Start.

Add to .windsurf/mcp.json:

.windsurf/mcp.json

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

Restart Windsurf to apply.

Add to settings.json (Cmd-,):

settings.json

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

After restarting, check the green connection indicator in the Agent Panel.

Add to ~/.codex/config.toml (or project-level .codex/config.toml):

config.toml

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

Run /mcp after restarting Codex to confirm.

Optional Configuration

环境变量	默认值	说明
`CACHE_TTL`	`1800`	Cache duration in seconds

Example: custom cache duration

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

Clear cache: rm -rf ~/.hpmcp/cache

Features

Zero config — Upstream URL is built in — just add the config
Auto caching — Responses are cached locally; repeat requests work offline
Offline ready — Falls back to cached data when upstream is unavailable
Zero dependencies — Pure Node.js with a tiny install size

Tool Updates on 2026-06-03

The upstream MCP has been upgraded from Pro-only (4 tools) to unified Pro + OSS (9 tools). hpmcp syncs automatically — no configuration changes needed.

New Tools (5)

Tool	Description
`get_component_source_code`	Get React/TypeScript source code for OSS components (only `@heroui/react`, excluding Pro)
`get_chat_export_manifest`	Get the file manifest for HeroUI AI Chat exports (commitSha, file list, preview URL)
`get_chat_export_files`	Fetch the content of specified exported files based on the manifest
`get_theme_variables`	Get theme variables and design tokens (default, brutalism, glass, mouve)

Changes to Existing Tools

Tool	Old Version	New Version
`list_components`	Lists Pro components only	Unified Pro + OSS list (133 components)
`get_component_docs`	Fixed enum, Pro only	Free string array, Pro + OSS
`get_css`	Pro only, includes theme parameter	Pro + OSS, theme parameter moved to `get_theme_variables`
`get_docs`	20 Pro doc paths	Significantly expanded, added `/pro/docs/react/...` and more OSS paths

MCP no longer distinguishes between Pro and OSS services — a single configuration gives you access to docs, source code, and theme variables for all components. If you previously configured OSS MCP separately, you can remove it.

This article was generated by CC, powered by GLM-5.1, based on the project source code.

hpmcp is the local proxy for the HeroUI Pro MCP Server. It automatically caches upstream responses, so it remains usable offline.

React Pro — Charts, advanced forms, navigation, overlays, data display.

Add to .cursor/mcp.json or Settings > Tools > MCP Servers:

.cursor/mcp.json

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

Enable the connection in Settings > Tools & MCPs.

Add from the command line:

terminal

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

Or add to .mcp.json:

.mcp.json

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

Run /mcp after restarting to confirm the connection.

Add to .vscode/mcp.json:

.vscode/mcp.json

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

Open the file and click Start.

Add to .windsurf/mcp.json:

.windsurf/mcp.json

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

Restart Windsurf to apply.

Add to settings.json (Cmd-,):

settings.json

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

After restarting, check the green connection indicator in the Agent Panel.

Add to ~/.codex/config.toml (or project-level .codex/config.toml):

config.toml

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

Run /mcp after restarting Codex to confirm.

Optional Configuration

环境变量	默认值	说明
`CACHE_TTL`	`1800`	Cache duration in seconds

Example: custom cache duration

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

Clear cache: rm -rf ~/.hpmcp/cache

Features

Zero config — Upstream URL is built in — just add the config
Auto caching — Responses are cached locally; repeat requests work offline
Offline ready — Falls back to cached data when upstream is unavailable
Zero dependencies — Pure Node.js with a tiny install size

Tool Updates on 2026-06-03

The upstream MCP has been upgraded from Pro-only (4 tools) to unified Pro + OSS (9 tools). hpmcp syncs automatically — no configuration changes needed.

New Tools (5)

Tool	Description
`get_component_source_code`	Get React/TypeScript source code for OSS components (only `@heroui/react`, excluding Pro)
`get_chat_export_manifest`	Get the file manifest for HeroUI AI Chat exports (commitSha, file list, preview URL)
`get_chat_export_files`	Fetch the content of specified exported files based on the manifest
`get_theme_variables`	Get theme variables and design tokens (default, brutalism, glass, mouve)

Changes to Existing Tools

Tool	Old Version	New Version
`list_components`	Lists Pro components only	Unified Pro + OSS list (133 components)
`get_component_docs`	Fixed enum, Pro only	Free string array, Pro + OSS
`get_css`	Pro only, includes theme parameter	Pro + OSS, theme parameter moved to `get_theme_variables`
`get_docs`	20 Pro doc paths	Significantly expanded, added `/pro/docs/react/...` and more OSS paths

环境变量

默认值

说明

CACHE_TTL

1800

Cache duration in seconds

环境变量

默认值

说明

CACHE_TTL

1800

Cache duration in seconds

Local MCP

Tool Updates on 2026-06-03

New Tools (5)

Changes to Existing Tools

On this page

Local MCP

Optional Configuration

Features

Tool Updates on 2026-06-03

New Tools (5)

Changes to Existing Tools

On this page

Local MCP

Optional Configuration

Features

Tool Updates on 2026-06-03

New Tools (5)

Changes to Existing Tools

On this page

Optional Configuration

Features

Optional Configuration

Features