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），只能在包含 canvas 元素的浏览器中运行。它可以操作导出场景中的对象，但无法创建场景或对象。
• Real-time API — Spline 编辑器中的一项功能，可让 Spline 向外部服务发出 API 调用。它不是入站 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 运行时代码：

• “生成一个 React 组件，加载我的 Spline 场景并为对象添加点击处理程序”
• “编写动画代码，让对象在悬停时旋转”
• “创建一个使用基于变量的状态管理的交互式场景”
• “生成集成 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 文件。