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 许可证。