Spline MCP

样条mcp

MCP服务器 样条设计 代码生成和资产管理。

概述

Spline.design是一个为网络导出交互式场景的3D设计工具。此MCP服务器提供：

• 代码生成：生成React、Next.js和vanilla js集成代码
• 资产管理：下载、缓存和验证 .splinecode 文件
• 集成支持：WebSocket（Mahavishnu）和n8n工作流集成
• 助手实用程序：URL构建、事件文档、代码片段

备注：Spline没有传统的REST API。场景在样条线编辑器中创建，并导出为 .splinecode 运行时使用的文件。

安装

uv pip install -e .

快速开始

生成React组件

spline-mcp generate react https://prod.spline.design/6Wq1Q7YGyM-iab9i/scene.splinecode

下载场景

spline-mcp download https://prod.spline.design/6Wq1Q7YGyM-iab9i/scene.splinecode

MCP服务器使用情况

标准模式（默认）

spline-mcp serve

HTTP模式

spline-mcp serve --http --port 3048

可用工具

代码生成

资产管理

助手实用程序

整合

配置

通过环境变量设置 SPLINE_ 前缀：

生成的代码示例

React 组件

import { Suspense, useRef, useCallback } from 'react';
import Spline from '@splinetool/react-spline';

interface HeroSceneProps {
  className?: string;
}

export function HeroScene({ className }: HeroSceneProps) {
  return (
    
      
    
  );
}

通过WebSocket集成

// Auto-generated WebSocket integration with soft failover
const { subscribe, isConnected } = useWebSocket('ws://localhost:8690');

useEffect(() => {
  if (!isConnected) return;

  const unsubscribe = subscribe('spline:variables', (data) => {
    splineRef.current?.setVariables(data);
  });

  return unsubscribe;
}, [isConnected]);

建筑

spline_mcp/
├── generators/         # Code generation (React, Vanilla, Next.js)
│   ├── base.py         # Base classes and types
│   ├── react.py        # React generator with FastBlocks patterns
│   ├── vanilla.py      # Vanilla JS/HTML generator
│   └── nextjs.py       # Next.js SSR generator
├── assets/             # Asset management
│   ├── manager.py      # Download, cache, validate
│   └── validator.py    # Scene file validation
├── integrations/       # External integrations
│   ├── websocket.py    # Mahavishnu WebSocket (soft failover)
│   └── n8n.py          # n8n workflow integration
├── tools/              # MCP tool definitions
│   ├── generation.py   # Code generation tools
│   ├── assets.py       # Asset management tools
│   ├── helpers.py      # Utility tools
│   └── integration.py  # Integration tools
├── config.py           # Oneiric-based configuration
└── server.py           # FastMCP application

生态系统整合

部分 博大生态系统:

许可证

BSD-3条款