Sketchfab MCP Server

🚀 Sketchfab MCP サーバー

Sketchfabの3Dモデルプラットフォームとやり取りするためのモデルコンテキストプロトコル（MCP）サーバーです。このMCPを使用すると、ClaudeやCursorを通じてSketchfab上で3Dモデルを検索、詳細を閲覧、ダウンロードすることができます。

✨ 主な機能

• 3Dモデルの検索：キーワード、タグ、カテゴリを使ってSketchfab上でモデルを検索します。
• モデル詳細の閲覧：特定のモデルに関する包括的な情報を取得します。
• モデルのダウンロード：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（オプション）：テキスト検索クエリ（例："自動車", "家", "キャラクター"）
• tags（オプション）：特定のタグでフィルタリング（例：["アニメーション", " rigged", " pbr"]）
• categories（オプション）：カテゴリでフィルタリング（例：["キャラクター", "建築", "車両"]）
• 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の設定 -> MCP -> 新しいMCPサーバーを追加します。
2. MCPを設定します。
   • 名前：Sketchfab MCP
   • タイプ：コマンド
   • コマンド：node /path/to/build/index.js --api-key YOUR_API_KEY

🔗 Claude Desktopとの統合

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

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

🌐 環境変数

以下の環境変数を設定することができます。

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

📄 ライセンス

ISC