Hyperiux Vault

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"]
    }
  }
}

サインイン

すべてのエフェクトのソースを取得するには、無料エフェクトも含め、Hyperiux アカウントへのサインインが必要です。このサーバーはトークンを次の順序で確認し、再利用します。

1. HYPERIUX_TOKEN 環境変数（/cli-auth で生成します）、次に
2. Hyperiux CLI の hyperiux login で保存済みのセッション（~/.hyperiux/auth.json）

トークンがない場合、include_source: true を指定した hyperiux_get_effect はメタデータ（説明、依存関係、変更履歴）と sign_in_required を返し、npx hyperiux login の実行を案内します。リスト表示、検索、詳細の取得（include_source: false）にはトークンは不要で、インストール数にもカウントされません。

ソースの取得は、アカウントの1日のインストール上限にカウントされます。この上限は、ウェブサイトと CLI の利用分と共有されます。Free は1日3件、Pro は5件、Pro+ は10件です。Pro エフェクトには Pro サブスクリプションも必要です。無料アカウントの場合は source_locked が返されます。

ツール

• hyperiux_list_effects - 名前の部分一致やカテゴリでカタログをページ分割して閲覧、検索します。各結果にはティア（free／pro）が含まれます。
• hyperiux_get_effect - 正確なスラッグを指定して、1つのエフェクトの詳細を取得します。説明、ティア、依存関係、バージョン、変更履歴、インストールコマンド、さらにオプションでソース全体を取得できます。
• 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

既知の制限

現在、どのツールもエフェクトの props を返しません。レジストリにはありますが、ツールではまだ公開されていません。hyperiux_list_effects は各エフェクトのティアを返しますが、ティアで絞り込むことはできません。返されたリストをご自身で集計または絞り込んでください。