STARWARCLOUD STARWAR.AI
返回市场
样条曲线-MCP服务器

样条曲线-MCP服务器

作者：aydinfer34 星标更新：2025-10-01
安装使用来源：spider==github.com

项目介绍

Spline.design 集成服务器

此服务器通过多种模式提供与 Spline.design 3D 场景的全面集成：

  1. MCP 服务器 - 为 Claude Desktop 提供完整的模型上下文协议集成
  2. Webhook 服务器 - 支持数据驱动可视化独立 webhook
  3. 最小服务器 - 具有基本功能的轻量级选项

功能

  • 全面的 3D 对象管理

    • 创建、修改和删除任何 3D 对象
    • 控制定位、旋转、缩放和可见性
    • 生成对象交互的运行时代码

  • 运行时 API 集成

    • 直接与 @splinetool/runtime 集成以实现编程控制
    • 生成可立即使用的 JavaScript、React 和 Next.js 代码
    • 创建交互式动画和行为
    • 实现自定义事件处理和场景操作

  • 高级材质系统

    • 创建具有广泛定制选项的分层材质
    • 支持所有 Spline 材质类型和属性
    • 配置复杂的着色选项

  • 完整的事件与动作系统

    • 支持 20 多种事件类型（鼠标、键盘、物理等）
    • 实现 15 种以上动作类型
    • 创建复杂的事件链和条件逻辑

  • Webhook 集成

    • 创建 webhook 以接收外部数据
    • 构建实时数据可视化
    • 连接到 Zapier、IFTTT、n8n 或自定义 API 等服务

安装

选项 1：本地安装并运行

# 克隆仓库
git clone https://github.com/yourusername/spline-mcp-server.git
cd spline-mcp-server

# 安装依赖
npm install

# 配置环境变量
cp config/.env.example .env

# 在 MCP 模式下启动服务器（适用于 Claude Desktop）
npm start

选项 2：运行不同的服务器模式

# 在 MCP 模式下启动（默认）
node bin/cli.js --mode mcp

# 在 webhook 模式下启动
node bin/cli.js --mode webhook

# 在最小模式下启动
node bin/cli.js --mode minimal

命令行选项

服务器支持通过统一 CLI 的各种命令行选项：

# 获取帮助
node bin/cli.js --help

# 使用 HTTP 传输的 MCP 模式
node bin/cli.js --mode mcp --transport http --port 3000

# 使用 stdio 传输的 MCP 模式（适用于 Claude Desktop）
node bin/cli.js --mode mcp --transport stdio

# webhook 服务器模式
node bin/cli.js --mode webhook --port 3000

项目结构

spline-mcp-server/
├── bin/                   # 可执行脚本
│   └── cli.js             # 统一 CLI 入口点
├── config/                # 配置文件
│   ├── .env.example       # 环境变量模板
│   └── *.json             # JSON 配置文件
├── docs/                  # 文档
│   ├── INSTALLATION.md    # 安装指南
│   ├── USAGE_GUIDE.md     # 使用说明
│   └── WEBHOOK_GUIDE.md   # webhook 特定指南
├── examples/              # 示例使用模式
├── package-templates/     # 不同模式下的 package.json 模板
├── public/                # Web 资产
│   └── webhook-ui.html    # webhook UI 接口
├── scripts/               # Shell 脚本
│   ├── install.sh         # 安装脚本
│   └── test-*.sh          # 测试脚本
├── src/                   # 源代码
│   ├── prompts/           # 提示模板
│   ├── resources/         # MCP 资源
│   ├── tools/             # MCP 工具
│   ├── utils/             # 工具函数
│   └── index.js           # 主 MCP 入口点
├── minimal.js             # 最小服务器实现
├── simple-webhook-server.js # 独立 webhook 服务器
├── LICENSE                # 许可证文件
├── README.md              # 项目说明
└── package.json           # 统一包文件

与 Claude Desktop 结合使用

此服务器设计用于在 MCP 模式下与 Claude Desktop 结合使用：

  1. 在 MCP 模式下使用 stdio 传输启动服务器：

    node bin/cli.js --mode mcp --transport stdio

  2. 在 Claude Desktop 中访问 MCP 连接设置

  3. 连接到服务器

  4. 开始通过 Claude 与 Spline.design 互动

使用 webhook 模式

webhook 服务器提供了一个简单的 Web 界面来创建和测试 webhook：

  1. 在 webhook 模式下启动服务器：

    node bin/cli.js --mode webhook

  2. 在 http://localhost:3000 打开 Web 界面

  3. 创建一个 webhook 并获取其 URL

  4. 在 Spline.design 中，在变量与数据面板中配置 webhook

  5. 发送测试数据以查看您的场景实时更新

示例

请参阅 examples/ 目录中的示例使用模式和常见工作流程。

文档

详细文档请参阅 docs/ 目录中的文件：

贡献

欢迎贡献！请随时提交拉取请求。

许可证

本项目根据 MIT 许可证发布 - 详情见 LICENSE 文件。