Hyperiux Vault

本地服务

vault.hyperiux.com开发工具1022 天前更新

代码仓库访问官网

关于 Hyperiux Vault

Hyperiux Vault 是供 AI 客户端使用的 MCP 服务，可查找和查看 React、Next.js 交互效果，并获取账户有权使用的效果源码。浏览目录和查询详情无需登录，获取源码则需要 Hyperiux 账户权限。

主要功能

01按名称或类别浏览、搜索效果
02查看效果说明、依赖、版本和更新记录
03获取安装命令及有权限的源码
04列出类别和效果数量

适用场景

01为 React 或 Next.js 项目查找交互效果
02安装前核对效果的依赖和版本
03获取账户有权使用的效果源码

MCP 相关

向 MCP 客户端提供目录浏览、搜索、类别和效果详情工具。获取源码需要登录 Hyperiux 账户，并受账户等级和每日安装限额约束。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "hyperiux-immersion-labs-hyperiux": {
      "command": "npx",
      "args": [
        "-y",
        "hyperiux-mcp-server"
      ]
    }
  }
}

启动命令npx -y hyperiux-mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmhyperiux-mcp-server0.3.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
limit	integer	否	返回的最大结果数。
query	string	否	按效果名称进行不区分大小写的子串匹配（例如 'cursor'、'text-reveal'）。省略则列出全部。
offset	integer	否	要跳过的结果数量，用于分页。
category	string	否	筛选一个类别，例如 'text'、'cursor'、'webgl'、'buttons'、'carousels'、'components'、'navigation'、'backgrounds'、'loaders'、'transitions'。使用 hyperiux_list_categories 查看所有有效值及其计数。

详细介绍

hyperiux-mcp-server

这是一个用于 Hyperiux Vault 效果注册表的 MCP（Model Context Protocol）服务。AI 客户端（Claude Code、Claude Desktop、Cursor 等）可以用它浏览、搜索和查看 React/Next.js 交互效果，并获取其有权使用的效果的可安装源代码。

安装

将以下内容添加到 MCP 客户端的配置中（例如 claude_desktop_config.json 或 Claude Code 的 .mcp.json）：

{
  "mcpServers": {
    "hyperiux": {
      "command": "npx",
      "args": ["-y", "hyperiux-mcp-server"]
    }
  }
}

没有令牌时，使用 include_source: true 调用 hyperiux_get_effect 会返回元数据（描述、依赖项、变更日志）和 sign_in_required，提示你运行 npx hyperiux login。列出、搜索和查看详情（include_source: false）无需令牌，也不会计入安装次数。

获取源代码会计入账户每日安装限额，与网站和 CLI 的使用共享：Free 每天 3 次，Pro 每天 5 次，Pro+ 每天 10 次。Pro 效果还需要 Pro 订阅；免费账户调用时会返回 source_locked。

工具

hyperiux_list_effects - 按名称子字符串和/或类别分页浏览、搜索目录。每个结果都会包含其等级（free/pro）。
hyperiux_get_effect - 按精确 slug 获取某个效果的完整详情：描述、等级、依赖项、版本、变更日志、安装命令，以及可选的完整源代码。
hyperiux_list_categories - 列出所有类别及其效果数量，便于缩小 hyperiux_list_effects 的搜索范围。

开发

pnpm --filter hyperiux-mcp-server build   # tsc -> dist/
pnpm --filter hyperiux-mcp-server test    # vitest
pnpm --filter hyperiux-mcp-server lint    # eslint
pnpm --filter hyperiux-mcp-server dev     # tsx watch, for local iteration

使用 MCP Inspector 对运行中的构建进行测试：

npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list
npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/call --tool-name hyperiux_get_effect --tool-arg name=dotted-grid