Spline MCP Server

Spline.design MCP サーバー（アーカイブ済み）

このプロジェクトはアーカイブされています。 Spline.design は公開 REST API を提供していないため、このサーバーの機能の大部分は動作しません。詳しくは以下をご覧ください。

アーカイブした理由

この MCP サーバーは、Claude を通じて Spline.design の 3D シーンをプログラムで操作するために構築されました。しかし、Spline はシーン操作用の公開 REST API を提供していません。api.spline.design を呼び出す約 130 個のツールは存在しないエンドポイントを対象としているため、ネットワークエラーが発生します。

Spline が実際に提供している開発者向けツールは次のとおりです。

• Code API — クライアントサイドの JavaScript ランタイム（@splinetool/runtime）です。キャンバス要素を含むブラウザー内でのみ動作します。エクスポート済みのシーン内のオブジェクトは操作できますが、シーンやオブジェクトは作成できません。
• Real-time API — Spline から外部サービスに API 呼び出しを行うための、Spline エディター内の機能です。外部から呼び出す API ではありません。

どちらも、この MCP サーバーが試みるようなサーバーサイドでのプログラム制御には対応していません。

動作する機能

10 個のコード生成ツールは、Vanilla JS、React、Next.js 向けの @splinetool/runtime コードを生成します。ただし、Claude は MCP サーバーなしでもこのコードを記述できるため、これらのツールは重複しています。

インストール

npx を使用する場合（Claude Desktop 向け）

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

{
  "mcpServers": {
    "spline": {
      "command": "npx",
      "args": ["-y", "spline-mcp-server"]
    }
  }
}

ローカル開発

git clone https://github.com/aydinfer/spline-mcp-server.git
cd spline-mcp-server
npm install
npm start

できること

Claude に、プロジェクト用の Spline ランタイムコードの生成を依頼できます。

• 「Spline シーンを読み込み、オブジェクトにクリックハンドラーを追加する React コンポーネントを生成して」
• 「オブジェクトにマウスを重ねたときに回転させるアニメーションコードを書いて」
• 「変数ベースの状態管理を使ったインタラクティブなシーンを作成して」
• 「Spline を統合した Next.js コードを生成して」

Claude はコード生成ツールを使って、Web プロジェクトにそのまま使用できる動作する @splinetool/runtime コードを生成します。

Spline Runtime API リファレンス

@splinetool/runtime は次のメソッドを提供しています（コード生成ツールはこれらのメソッドを対象とします）。

メソッド	説明
findObjectByName(name)	名前でオブジェクトを検索
findObjectById(uuid)	ID でオブジェクトを検索
getAllObjects()	すべてのシーンオブジェクトを一覧表示
emitEvent(event, nameOrUuid)	オブジェクトでイベントを発生させる
addEventListener(event, cb)	シーンイベントを監視
setVariable(name, value)	シーン変数を設定
getVariable(name)	シーン変数を取得
setZoom(value)	ズームレベルを制御
play() / stop()	レンダリングを制御

オブジェクトには position、rotation、scale、visible、intensity プロパティが公開されています。

プロジェクト構成

spline-mcp-server/
├── src/
│   ├── tools/             # MCP tool implementations
│   │   └── design/        # Advanced design tools (pending API)
│   ├── utils/             # API client and runtime manager
│   ├── prompts/           # Prompt templates
│   ├── resources/         # MCP resources
│   └── index.js           # Main server entry point
├── bin/cli.js             # CLI entry point
├── docs/                  # Documentation
└── package.json

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳しくは LICENSE ファイルをご覧ください。