Versuz

---

できること

Model Context Protocol は、Claude Code が外部ツールを呼び出せるようにする Anthropic の標準規格です。@versuz/mcp は Versuz カタログを 5 つのツールとして公開するため、次のような指示ができます。

「SQL のマイグレーションスキルを探してインストールして」

「Next.js プロジェクト向けの CLAUDE.md ファイルを上位 10 件表示して」

「pdf-pro スキルの事前スコアと Elo を表示して」

Claude がツールを呼び出し、結果を要約して、適切なファイルをダウンロードします。コピー＆ペーストも、ブラウザーへの切り替えも不要です。

インストール

claude mcp add versuz npx -y @versuz/mcp

または、プロジェクトの .mcp.json を使って手動で設定します。

{
  "mcpServers": {
    "versuz": {
      "command": "npx",
      "args": ["-y", "@versuz/mcp"],
      "env": {
        "VERSUZ_API": "https://versuz.dev"
      }
    }
  }
}

Claude Code を再起動します。ツール一覧に Versuz の 5 つのツールが表示されます。

公開されるツール

ツール	説明
versuz_search	スキルと CLAUDE.md を全文検索します。それぞれ上位 15 件を返します。
versuz_list_skills	category / tier / sort フィルターを使って、ページネーション付きで一覧を表示します。
versuz_list_claude_md	CLAUDE.md についても同じ形式で表示します（カテゴリ：nextjs · react · python-data · backend-api · mobile · devops · ml-training · generic）。
versuz_get	スラッグの詳細情報をすべて取得します。Elo、事前スコア、ライセンス、GitHub URL、バンドルファイル、ツール、モデルが含まれます。
versuz_install	.claude/skills/<slug>/SKILL.md（スキル）または ./CLAUDE.md（claude_md）にダウンロードします。無料アイテムのみが対象です。プレミアムアイテムの場合は buy_url を返します。

セッション例

あなた：「PDF から表を抽出できるスキルが必要です。」

Claude：

[invoking versuz_search({query: "pdf table extraction"})]

Found 3 candidates :
- pdf-table-extractor (prior 1721, ★ 8.2k, FEATURED $4.99)
- pdf-extract-anthropic (prior 1846, ★ 12.4k, FREE)
- table-from-pdf-claude (prior 1432, ★ 950, FREE)

Recommend pdf-extract-anthropic — highest prior + free. Install ?

あなた：「はい」

Claude：

[invoking versuz_install({slug: "pdf-extract-anthropic"})]

✓ Wrote .claude/skills/pdf-extract-anthropic/SKILL.md (3.2 KB)
Source : github.com/anthropics/skills/blob/main/pdf-extract/SKILL.md

設定

環境変数	デフォルト	効果
VERSUZ_API	https://versuz.dev	API ホストです。ローカル開発の場合は http://localhost:3000 に設定します。

MCP の設定を通じて渡すこともできます。

{
  "mcpServers": {
    "versuz": {
      "command": "npx",
      "args": ["-y", "@versuz/mcp"],
      "env": { "VERSUZ_API": "http://localhost:3000" }
    }
  }
}

インストール先

ツールは、MCP サーバーの実行場所ではなく、Claude Code が実行されているプロジェクトのルートを基準にファイルを書き込みます。

種類	保存先
skill	<project>/.claude/skills/<slug>/SKILL.md
claude_md	<project>/CLAUDE.md

必要に応じて、versuz_install の cwd 引数で保存先を上書きできます。

プレミアムアイテムの処理

プレミアムアイテムは、API から 402 Payment Required を返します。MCP サーバーは、その内容を分かりやすいメッセージとして転送します。

Error: Premium skill — purchase required to download via MCP.
Buy at: https://versuz.dev/buy/skill/<slug>

ウェブで購入すると、その後はインストールできるようになります（v0.2 で対応予定です。現在、MCP はユーザー認証を渡さないため、無料アイテムのみダウンロードできます）。

バンドルのサポート（v0.2）

CLI と同じ制約があります。バンドルされたスキル（SKILL.md + scripts/refs）は、現時点では SKILL.md のみダウンロードされます。/api/v1/skills/<slug>/bundle.zip の提供開始後に、versuz_install の bundle: true 引数をロードマップに追加しています。

ロードマップ（v0.2）

• versuz_submit ツール — 自分の GitHub リポジトリからスキルを公開します（CLI と同様）。
• GitHub Device Flow 認証 — MCP 経由のプレミアムダウンロードに対応します。
• バンドルのダウンロード — zip に対応します。
• versuz_judge — MCP から品質判定を実行します（管理者のみ）。

開発

cd mcp-server
npm install
node bin/server.js          # runs on stdio, waits for MCP client

サーバーは起動時に [versuz-mcp] running on stdio · api=<url> を stderr に出力します。stdout は MCP プロトコル専用です。

@modelcontextprotocol/inspector を使って単独でテストできます。

npx @modelcontextprotocol/inspector node bin/server.js

技術スタック

• @modelcontextprotocol/sdk ^1.0
• Stdio トランスポート（ネットワークリスナーなし）
• 純粋な Node 18+、ESM

ライセンス

MIT — LICENSE を参照してください。