Sketchfab MCP Server

Sketchfab MCP サーバー

Sketchfab の 3D モデルプラットフォームと連携するための Model Context Protocol（MCP）サーバーです。この MCP を使用すると、Claude または Cursor から直接、Sketchfab 上の 3D モデルを検索し、詳細を確認してダウンロードできます。

機能

• 3D モデルの検索：キーワード、タグ、カテゴリを使って Sketchfab 上のモデルを検索します
• モデルの詳細表示：特定のモデルに関する詳細情報を取得します
• モデルのダウンロード：さまざまな形式（gltf、glb、usdz、source）でモデルをダウンロードします

前提条件

• Node.js 18 以降
• Sketchfab API キー（認証用）

インストール

1. このリポジトリをクローンします
2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

使用方法

MCP サーバーの実行

npm start

Sketchfab API キーを指定するには、--api-key パラメーターを使用します：

node build/index.js --api-key YOUR_API_KEY

または、SKETCHFAB_API_KEY 環境変数を設定できます：

export SKETCHFAB_API_KEY=YOUR_API_KEY
npm start

利用可能なツール

1. sketchfab-search

キーワードとフィルターを使って Sketchfab 上の 3D モデルを検索します。

パラメーター：

• query（任意）：テキスト検索クエリ（例："car"、"house"、"character"）
• tags（任意）：特定のタグで絞り込みます（例：["animated", "rigged", "pbr"]）
• categories（任意）：カテゴリで絞り込みます（例：["characters", "architecture", "vehicles"]）
• downloadable（任意）：ダウンロード可能なモデルのみを表示する場合は true に設定します
• limit（任意）：返す結果の最大数（1～24、デフォルト：10）

2. sketchfab-model-details

特定の Sketchfab モデルに関する詳細情報を取得します。

パラメーター：

• modelId：Sketchfab モデルの一意の ID

3. sketchfab-download

Sketchfab から 3D モデルをダウンロードします。

パラメーター：

• modelId：ダウンロードする Sketchfab モデルの一意の ID
• format（任意）：モデルのダウンロード形式（gltf、glb、usdz、source）
• outputPath（任意）：ダウンロードしたファイルを保存するローカルディレクトリまたはファイルパス

Cursor での使用

1. Cursor の Settings -> MCP -> Add new MCP server に移動します
2. MCP を設定します：
   • 名前：Sketchfab MCP
   • 種類：command
   • コマンド：node /path/to/build/index.js --api-key YOUR_API_KEY

Claude Desktop での使用

以下の MCP 設定を Claude Desktop の設定に追加します：

{
  "mcpServers": {
    "sketchfab": {
      "command": "node",
      "args": ["/path/to/build/index.js", "--api-key", "YOUR_API_KEY"]
    }
  }
}

環境変数

以下の環境変数を設定できます：

• SKETCHFAB_API_KEY：Sketchfab API キー（--api-key パラメーターで指定する代わりに使用します）

ライセンス

ISC