Spline MCP Server

🚀 Spline 中間件控制面板（MCP）服務器

Spline 中間件控制面板（MCP）服務器是一個用於與 Spline 3D 設計工具 API 交互的服務器。它為 Claude 提供了便捷接口，可使用 Spline 的各類功能，如導出場景、導入模型、創建動畫以及管理項目等。

🚀 快速開始

Spline 中間件控制面板（MCP）服務器為開發者提供了與 Spline 3D 設計工具 API 交互的能力，藉助它，Claude 能夠方便地調用 Spline 的各項功能。

✨ 主要特性

基本操作

• 將 Spline 場景導出為多種格式（GLB、GLTF、FBX、OBJ）。
• 將 3D 模型導入到 Spline 中。
• 獲取 Spline 場景的詳細信息。
• 列出可用的 Spline 場景。

動畫功能

• 為對象創建關鍵幀動畫。
• 觸發現有的動畫。
• 列出場景中的動畫。
• 創建基於事件觸發的動畫（onClick、onHover 等）。

📦 安裝指南

使用 npm 安裝

npm install spline-mcp-server

使用 npx 直接運行

npx spline-mcp-server

📚 詳細文檔

配置

創建一個 .env 文件，包含您的 Spline API 憑據：

SPLINE_API_KEY=your_api_key_here
SPLINE_API_URL=https://api.spline.design

使用方法

此 MCP 服務器可用於與 Claude 一起使用，以交互 Spline 的功能。以下是幾個使用示例：

基本操作

將我的 Spline 場景（ID "abc123"）導出為 GLB 格式

從 "https://example.com/model.glb" 導入 3D 模型到我的 Spline 項目中

獲取場景 ID "abc123" 的詳細信息

列出我可用的 Spline 場景

動畫操作

為場景 "abc123" 中的對象創建名為 "Rotate" 的動畫

觸發場景 "abc123" 中對象的 "Bounce" 動畫

列出場景中的所有動畫

動畫示例

基本的創建動畫

在場景 "abc456" 中為對象 "cube-123" 創建名為 "Spin" 的動畫，帶有旋轉關鍵幀

高級的創建動畫

在場景 "abc456" 中為對象 "button-123" 創建名為 "Grow" 的 onClick 動畫，使其縮放至原大小的 1.5 倍

觸發動畫

在場景 "abc456" 中觸發對象 "heart-123" 的 "Pulse" 動畫，並啟用循環

API 文檔

有關 Spline API 的更多信息，請參閱 官方文檔。

📄 許可證

本項目採用 MIT 許可證。