Linkedsword

Roblox Studio MCP 服务器 + 插件 — 73 种用于脚本编辑、批量操作、游戏测试自动化等的工具。

Linkedsword 将 BoshyXD 的社区 MCP（批量操作、grep、构建库）与 Roblox 官方 MCP（游戏测试自动化、虚拟输入、多实例）的精华结合到一个软件包中，并在此基础上增加了脚本差异对比审查功能。

功能特性

脚本差异对比审查 — 在 Studio 插件内提供 GitHub 风格的内联差异对比。在应用之前，可以接受或拒绝单个代码块。
73 种工具 — 导航、搜索、脚本编辑、实例操作、游戏测试控制、空间操作等。
批量操作 — 在多个实例中批量创建、复制和设置属性。
活动摘要 — 实时记录每次工具调用的时间及状态。
模式系统 — 全功能（读+写）、检查器（只读）或自动接受（用于无人值守工作流）。

快速入门

前置要求

Node.js 18+
Roblox Studio

1. 安装 MCP 服务器

# Claude Code
claude mcp add linkedsword -- npx -y linkedsword-mcp-server@latest

# Or add to your MCP config (Claude Desktop, Cursor, etc.)
{
  "mcpServers": {
    "linkedsword": {
      "command": "npx",
      "args": ["-y", "linkedsword-mcp-server@latest"]
    }
  }
}

2. 安装 Studio 插件

# Clone the repo
git clone https://github.com/yannyhl/melo-mcp.git
cd melo-mcp
npm install

# Build and install the plugin
npm run install-plugin --workspace=packages/server

这将构建 Linkedsword.rbxmx 并将其复制到你的本地插件文件夹：

macOS: ~/Documents/Roblox/Plugins/
Windows: %LOCALAPPDATA%/Roblox/Plugins/

3. 在 Studio 中启用 HTTP 请求

在 Roblox Studio 中：File > Game Settings > Security > Allow HTTP Requests（启用它）。

插件通过 localhost:3003 上的 HTTP 与 MCP 服务器通信。此设置针对每个地点（place）生效。

4. 连接

在 Roblox Studio 中打开一个地点。
点击插件工具栏中的 Linkedsword。
小部件应显示“已连接”状态。
开始从你的 MCP 客户端使用工具。

架构

MCP Client (Claude Code, Cursor, etc.)
  ── stdio ──>  Linkedsword MCP Server (Node/TypeScript)
                  ├── Diff Engine (Myers' algorithm)
                  └── HTTP Bridge (long-poll, localhost:3003)
                        ── HTTP ──>  Roblox Studio Plugin (Luau)
                                       ├── Tool Handlers
                                       ├── Diff Review UI
                                       └── Activity Feed

工具注册表 (73)

导航 (6)

get_file_tree . get_project_structure . get_place_info . get_services . list_roblox_studios . set_active_studio

搜索与检查 (11)

search_files . search_objects . search_by_property . get_instance_properties . get_instance_children . get_class_info . get_selection . grep_scripts . mass_get_property . set_selection . get_descendants

脚本编辑 (9 — 带差异暂存)

get_script_source . set_script_source . patch_script . grep_replace . execute_luau . run_code . edit_script_lines . insert_script_lines . delete_script_lines

实例操作 (13)

create_object . delete_object . set_property . mass_create_objects . mass_set_property . mass_duplicate . smart_duplicate . set_calculated_property . clone_object . reparent_object . group_objects . ungroup_objects . batch_operations

游戏测试自动化 (8)

start_playtest . stop_playtest . get_playtest_output . get_studio_mode . run_script_in_play_mode . user_mouse_input . user_keyboard_input . character_navigation

差异对比与元数据 (21)

get_diff_queue . resolve_diff . get_diff_history . get_activity_log . set_mode . rollback . redo . get_attribute . get_attributes . set_attribute . delete_attribute . get_tags . get_tagged . add_tag . remove_tag . capture_screenshot . export_build . import_build . list_library . insert_model . get_console_output

空间操作 (5)

create_weld . get_bounding_box . raycast . fill_terrain . clear_terrain

开发

git clone https://github.com/yannyhl/melo-mcp.git
cd melo-mcp
npm install

# Build server
npx tsup packages/server/src/index.ts --format cjs --out-dir packages/server/dist --clean

# Build plugin
node packages/plugin/build-rbxmx.js

# Deploy plugin to Studio
cp packages/plugin/Linkedsword.rbxmx ~/Documents/Roblox/Plugins/Linkedsword.rbxmx

本地 MCP 配置

将 .mcp.json.example 复制到 .mcp.json 并根据需要调整路径：

cp .mcp.json.example .mcp.json

项目结构

melo-mcp/
├── packages/
│   ├── server/               # MCP server (TypeScript)
│   │   ├── src/
│   │   │   ├── index.ts      # Entry point
│   │   │   ├── services/
│   │   │   │   ├── bridge.ts       # HTTP long-poll bridge
│   │   │   │   └── diff-engine.ts  # Myers' diff computation
│   │   │   └── tools/
│   │   │       ├── navigation.ts   # 6 tools
│   │   │       ├── search.ts       # 11 tools
│   │   │       ├── script.ts       # 9 tools
│   │   │       ├── instance.ts     # 13 tools
│   │   │       ├── playtest.ts     # 8 tools
│   │   │       ├── diff-meta.ts    # 21 tools
│   │   │       └── spatial.ts      # 5 tools
│   │   └── package.json
│   └── plugin/               # Roblox Studio plugin (Luau)
│       └── src/
│           └── plugin.luau   # Single-file plugin (~4700 lines)
├── docs/
│   └── README.md             # Internal handbook (architecture, caveats, LLM guide)
├── .mcp.json.example         # MCP config template
└── README.md

已知限制

在快速并行工具调用时会出现心跳超时（重试有效）。
重启 MCP 服务器需要重新加载编辑器窗口。
user_mouse_input 和 user_keyboard_input 在插件中尚未完全实现。
capture_screenshot 尚不可用。
沙盒模式已声明但未实现。

请参阅 docs/README.md 获取完整的注意事项列表。

许可证

MIT

Melo