Vfx Forge MCP

VFX Forge MCP服务器

MCP（模型上下文协议）服务器，使AI代理能够与VFX Forge Roblox插件交互，以创建和操纵视觉效果。

概述

该项目在AI代理（如Claude）和在Roblox Studio中运行的VFX Forge插件之间架起了一座桥梁。它允许代理人：

• 探索和查询Roblox DataModel层次结构
• 创建、修改和删除实例
• 操纵属性和特性
• 部分使用VFX Forge的一些工具/功能
• 离线访问Roblox API文档

MCP服务器通过标准MCP协议（stdio）与AI代理通信，并通过WebSocket与VFX Forge插件进行实时双向通信。

安装

自动设置

暂无

本地设置

1. 安装依赖项：

cd vfx-forge-mcp
bun install

1. 配置您的MCP客户端以使用此服务器。对于Claude Desktop，添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "vfx-forge": {
      "command": "bun",
      "args": ["run", "/path/to/vfx-forge-mcp/src/index.ts"],
      "env": {
        "VFX_FORGE_PORT": "3847"
      }
    }
  }
}

1. 在Roblox Studio的VFX Forge插件设置中启用MCP桥。

跑步

# Start the server
bun run start

# Development mode with hot reload
bun run dev

# Type checking
bun run typecheck

健康检查

WebSocket服务器在以下位置公开健康端点 http://localhost:3847/health:

{
  "status": "ok",
  "connected": true,
  "pendingRequests": 0,
  "pluginVersion": "1.0.0",
  "uptime": 12345
}

环境变量