Spline

v1.0.0Developer Toolsstable

An interface that enables Claude to interact with Spline 3D design tool, allowing operations like exporting scenes, importing models, and creating animations through natural language commands.

spline-mcp-servermcpai-integration
Share:
69
Stars
0
Downloads
0
Weekly
0/5

What is Spline?

Spline is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to interface that enables claude to interact with spline 3d design tool, allowing operations like exporting scenes, importing models, and creating animations through natural language commands.

An interface that enables Claude to interact with Spline 3D design tool, allowing operations like exporting scenes, importing models, and creating animations through natural language commands.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An interface that enables Claude to interact with Spline 3D

Use Cases

Export 3D scenes and models from Spline.
Import 3D models into Spline designs.
Create and animate 3D designs through natural language.
aydinfer

Maintainer

LicenseMIT License
Languagejavascript
Versionv1.0.0
UpdatedMay 16, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx spline-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Spline

The spline-mcp-server enables Claude to interact with the Spline 3D design tool through natural language, generating integration code for embedding and controlling Spline scenes in JavaScript, React, and Next.js applications using the @splinetool/runtime library. It covers object queries, event emission, variable management, playback control, and scene loading — giving developers working AI-generated starter code for Spline web integrations. Use it to skip manual API documentation lookups and get runnable code snippets directly from Claude.

Prerequisites

  • Node.js 16 or later with npx available
  • A Spline account with at least one published scene (spline.design)
  • The @splinetool/runtime npm package in your web project for runtime code to execute
  • An MCP-compatible client such as Claude Desktop
1

Add the server to Claude Desktop configuration

Open your Claude Desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows) and add the spline-mcp-server entry.

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

Restart Claude Desktop

Quit and reopen Claude Desktop so it loads the new MCP server. npx will download spline-mcp-server on first use. No API key or environment variables are required.

3

Publish your Spline scene and copy the scene URL

In the Spline editor, click Export or Share, set visibility to Public, and copy the .splinecode URL. You will pass this URL to Claude when asking for integration code.

4

Install the Spline runtime in your project

Add @splinetool/runtime to the web project where you want to embed the Spline scene. This is the library that the generated code depends on.

npm install @splinetool/runtime
5

Ask Claude to generate integration code

Provide your scene URL and describe what interactions you need. Claude will use the MCP tools to produce working runtime code tailored to your framework.

Spline Examples

Client configuration

claude_desktop_config.json entry for the spline-mcp-server. No credentials required.

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

Prompts to try

Example natural-language prompts for generating Spline scene integrations.

- "Generate a React component that loads my Spline scene from https://prod.spline.design/abc123/scene.splinecode and triggers an animation when a button is clicked"
- "Write a Next.js page that embeds a Spline scene and hides the object named 'Overlay' after 3 seconds"
- "Create vanilla JavaScript that loads a Spline scene, finds an object called 'Cube', and changes its position on mouse move"
- "Show me how to use emitEvent to trigger a 'hover' event on the 'Logo' object in my Spline scene"

Troubleshooting Spline

Generated code throws 'Cannot find module @splinetool/runtime'

Run 'npm install @splinetool/runtime' in your web project directory. The generated code imports from this package, which must be installed separately from the MCP server.

Scene fails to load in the browser with a CORS or 404 error

Make sure your Spline scene is published and set to Public visibility. The URL must end with .splinecode. Private or unpublished scenes will return 403 or 404 errors at runtime.

Claude says no spline tools are available

Verify the config uses 'spline-mcp-server' (with hyphens, not 'spline'). Restart Claude Desktop after editing the config. Run 'npx -y spline-mcp-server' in a terminal to confirm the package downloads without errors.

Frequently Asked Questions about Spline

What is Spline?

Spline is a Model Context Protocol (MCP) server that interface that enables claude to interact with spline 3d design tool, allowing operations like exporting scenes, importing models, and creating animations through natural language commands. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Spline?

Follow the installation instructions on the Spline GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Spline?

Spline works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Spline free to use?

Yes, Spline is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Spline?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides