Sketchfab MCP Server

Sketchfab MCP サーバー

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

特徴

• 3Dモデルの検索：キーワード、タグ、カテゴリを使用してSketchfabでモデルを検索します
• モデルの詳細を表示: 特定のモデルに関する包括的な情報を取得します
• モデルのダウンロード: さまざまな形式 (gltf、glb、usdz、ソース) でモデルをダウンロードします。

前提条件

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

インストール

1. このリポジトリをクローンする
2. 依存関係をインストールします:
   npm install
3. プロジェクトをビルドします。
   npm run build

使用法

MCPサーバーの実行

Sketchfab API キーを提供するには、 --api-keyパラメータを使用します。

あるいは、 SKETCHFAB_API_KEY環境変数を設定することもできます。

利用可能なツール

1. スケッチファブ検索

キーワードとフィルターに基づいて Sketchfab で 3D モデルを検索します。

パラメータ:

• query （オプション）: テキスト検索クエリ（例：「車」、「家」、「キャラクター」）
• tags （オプション）：特定のタグでフィルタリングします（例：["animated", "rigged", "pbr"]）
• categories （オプション）：カテゴリでフィルタリングします（例：["キャラクター"、"建築"、"乗り物"]）
• downloadable （オプション）：ダウンロード可能なモデルのみを表示するにはtrueに設定します
• limit (オプション): 返される結果の最大数 (1-24、デフォルト: 10)

2. スケッチファブモデルの詳細

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

パラメータ:

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

3. SketchFab ダウンロード

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

パラメータ:

• modelId : ダウンロードするSketchfabモデルの一意のID
• format （オプション）：モデルをダウンロードするための推奨フォーマット（gltf、glb、usdz、ソース）
• outputPath (オプション): ダウンロードしたファイルを保存するローカルディレクトリまたはファイルパス

カーソルの使用

1. カーソル設定 -> MCP -> 新しいMCPサーバーの追加に移動します
2. MCP を構成します。
   • 名前: Sketchfab MCP
   • タイプ: コマンド
   • コマンド: node /path/to/build/index.js --api-key YOUR_API_KEY

Claude Desktopでの使用

次の MCP 構成を Claude Desktop 構成に追加します。

環境変数

次の環境変数を設定できます。

• SKETCHFAB_API_KEY : Sketchfab API キー (--api-key パラメータで渡す代わりに使用できます)

ライセンス

ISC