Skip to content
Back to search

spline-mcp-server

An MCP server for working with Spline 3D design tool API

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aydinfer--spline-mcp-server/badge.svg)](/listings/aydinfer--spline-mcp-server)

HTML

<a href="/listings/aydinfer--spline-mcp-server"><img src="/api/listings/aydinfer--spline-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Using npx (for Claude Desktop)

Add this to your Claude Desktop MCP config:

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

Local development

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 93 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Spline.design MCP Server (Archived)
  2. > **This project is archived.** Spline.design does not provide a public REST API, making most of this server's functionality non-operational. See below for details.
  3. ## Why archived
  4. This MCP server was built to programmatically control Spline.design 3D scenes through Claude. However, **Spline does not offer a public REST API** for scene manipulation. The ~130 tools that call `api.spline.design` target endpoints that don't exist and will fail with network errors.
  5. Spline's actual developer tools are:
  6. - **[Code API](https://docs.spline.design/exporting-your-scene/web/code-api-for-web)** — A client-side JavaScript runtime (`@splinetool/runtime`) that only works in a browser with a canvas element. It can manipulate objects in exported scenes but cannot create scenes or objects.
  7. - **[Real-time API](https://docs.spline.design/interaction-states-events-and-actions/real-time-api)** — A feature inside the Spline editor for making outbound API calls from Spline to external services. Not an inbound API.
  8. Neither of these enables the kind of server-side programmatic control this MCP server attempts.
  9. ### What does work
  10. 10 **code generation tools** generate `@splinetool/runtime` code for Vanilla JS, React, and Next.js. However, Claude can already write this code without an MCP server, making these tools redundant.
  11. ## Installation
  12. ### Using npx (for Claude Desktop)
  13. Add this to your Claude Desktop MCP config:
  14. ```json
  15. {
  16. "mcpServers": {
  17. "spline": {
  18. "command": "npx",
  19. "args": ["-y", "spline-mcp-server"]
  20. }
  21. }
  22. }
  23. ```
  24. ### Local development
  25. ```bash
  26. git clone https://github.com/aydinfer/spline-mcp-server.git
  27. cd spline-mcp-server
  28. npm install
  29. npm start
  30. ```
  31. ## What you can do with it
  32. Ask Claude to generate Spline runtime code for your projects:
  33. - "Generate a React component that loads my Spline scene and adds click handlers to objects"
  34. - "Write animation code that rotates an object on hover"
  35. - "Create an interactive scene with variable-based state management"
  36. - "Generate Next.js code with Spline integration"
  37. Claude will use the code generation tools to produce working `@splinetool/runtime` code you can use directly in your web projects.
  38. ## Spline Runtime API Reference
  39. The `@splinetool/runtime` provides these methods (which the code generation tools target):
  40. | Method | Description |
  41. |---|---|
  42. | `findObjectByName(name)` | Find an object by name |
  43. | `findObjectById(uuid)` | Find an object by ID |
  44. | `getAllObjects()` | List all scene objects |
  45. | `emitEvent(event, nameOrUuid)` | Trigger an event on an object |
  46. | `addEventListener(event, cb)` | Listen for scene events |
  47. | `setVariable(name, value)` | Set a scene variable |
  48. | `getVariable(name)` | Get a scene variable |
  49. | `setZoom(value)` | Control zoom level |
  50. | `play()` / `stop()` | Control rendering |
  51. Objects expose `position`, `rotation`, `scale`, `visible`, and `intensity` properties.
  52. ## Project Structure
  53. ```
  54. spline-mcp-server/
  55. ├── src/
  56. │ ├── tools/ # MCP tool implementations
  57. │ │ └── design/ # Advanced design tools (pending API)
  58. │ ├── utils/ # API client and runtime manager
  59. │ ├── prompts/ # Prompt templates
  60. │ ├── resources/ # MCP resources
  61. │ └── index.js # Main server entry point
  62. ├── bin/cli.js # CLI entry point
  63. ├── docs/ # Documentation
  64. └── package.json
  65. ```
  66. ## License
  67. This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.