Qrwc Svelte MCP

QRWC Svelte MCP

用于Svelte项目的模型上下文协议（MCP）服务器，使用 qrwc苗条 npm包。此MCP服务器提供工具、资源和提示，以帮助LLM构建与Q-SYS系统交互的UI组件。

⚠️ 实验性：此MCP服务器目前处于实验阶段。API和功能可能会发生变化。

💡 推荐：为了获得最佳体验，请将此MCP服务器与 Svelte MCP官方服务器 获取全面的Svelte文档和代码分析。

概述

QRWC Svelte MCP服务器通过提供以下功能帮助LLM和AI代理为Q-SYS系统编写更好的代码：

• 从Q-SYS Core中发现组件和控件的工具
• 使用qrwc-svelte的文档资源
• 常见控件类型的示例代码
• 针对Q-SYS开发任务优化的提示

需求

• Q-SYS核心IP地址（作为第一个参数是必需的）-仅支持硬件和VCore，不支持仿真。
• 已安装Node.js（用于运行MCP服务器）

设置

设置因您选择的MCP客户端而异。核心IP地址必须作为第一个参数提供，您可以选择传递 --no-svelte 禁用Svelte特定的资源和提示（如果您使用的是不同的UI框架，则很有用）。

命令格式

npx qrwc-svelte-mcp  [--no-svelte]

克劳德代码

要在Claude Code中包含QRWC Svelte MCP服务器，请运行：

claude mcp add -t stdio -s [scope] qrwc-svelte -- npx qrwc-svelte-mcp 

替换 ` 使用您的Q-SYS核心IP地址。这 [scope] 必须 user, project 或 local`.

要禁用Svelte特定资源，请执行以下操作：

claude mcp add -t stdio -s [scope] qrwc-svelte -- npx qrwc-svelte-mcp  --no-svelte

克劳德桌面

在“设置”>“开发人员”部分，单击“编辑配置”。它将打开一个文件夹 claude_desktop_config.json 文件。编辑该文件以包含以下配置：

{
	"mcpServers": {
		"qrwc-svelte": {
			"command": "npx",
			"args": ["-y","qrwc-svelte-mcp",""]
		}
	}
}

替换 `` 使用您的Q-SYS核心IP地址。

要禁用Svelte特定资源，请执行以下操作：

{
	"mcpServers": {
		"qrwc-svelte": {
			"command": "npx",
			"args": ["-y","qrwc-svelte-mcp","", "--no-svelte"]
		}
	}
}

Codex CLI

将以下内容添加到您的 config.toml （默认为 ~/.codex/config.toml):

[mcp_servers.qrwc-svelte]
command = "npx"
args = ["-y", "qrwc-svelte-mcp", ""]

替换 `` 使用您的Q-SYS核心IP地址。

要禁用Svelte特定资源，请执行以下操作：

[mcp_servers.qrwc-svelte]
command = "npx"
args = ["-y", "qrwc-svelte-mcp", "", "--no-svelte"]

Gemini CLI

要在Gemini CLI中包含QRWC Svelte MCP服务器，请运行：

gemini mcp add -t stdio -s [scope] qrwc-svelte npx -y qrwc-svelte-mcp 

替换 ` 使用您的Q-SYS核心IP地址。这 [scope] 必须 user, project 或 local`.

要禁用Svelte特定资源，请执行以下操作：

gemini mcp add -t stdio -s [scope] qrwc-svelte npx -y qrwc-svelte-mcp  --no-svelte

OpenCode

运行命令：

opencode mcp add

并按照说明操作，在“选择MCP服务器类型”提示下选择“本地”：

opencode mcp add

┌  Add MCP server
│
◇  Enter MCP server name
│  qrwc-svelte
│
◇  Select MCP server type
│  Local
│
◆  Enter command to run
│  npx -y qrwc-svelte-mcp 

替换 `` 使用您的Q-SYS核心IP地址。

VS Code

1. 打开命令面板
2. 选择“MCP：添加服务器…”
3. 选择“命令（stdio）”
4. 插入 npx -y qrwc-svelte-mcp 在输入中，然后按 Enter （替换 `` 使用您的Q-SYS核心IP地址）
5. 当系统提示输入名称时，插入 qrwc-svelte
6. 如果要将其添加为 Global 或 Workspace MCP服务器

要禁用Svelte特定资源，请使用 npx -y qrwc-svelte-mcp --no-svelte 在步骤4中。

光标

1. 打开命令面板
2. 选择“查看：打开MCP设置”
3. 点击“添加自定义MCP”

它将打开一个包含MCP服务器的文件，您可以在其中添加以下配置：

{
	"mcpServers": {
		"qrwc-svelte": {
			"command": "npx",
			"args": ["-y", "qrwc-svelte-mcp", ""]
		}
	}
}

替换 `` 使用您的Q-SYS核心IP地址。

要禁用Svelte特定资源，请执行以下操作：

{
	"mcpServers": {
		"qrwc-svelte": {
			"command": "npx",
			"args": ["-y", "qrwc-svelte-mcp", "", "--no-svelte"]
		}
	}
}

泽德

1. 打开命令面板
2. 搜索并选择“代理：打开设置”
3. 在设置面板中查找 Model Context Protocol (MCP) Servers
4. 点击“添加服务器”
5. 选择：“添加自定义服务器”

它将打开一个带有MCP服务器配置的弹出窗口，您可以在其中添加以下配置：

{
	"qrwc-svelte": {
		"command": "npx",
		"args": ["-y", "qrwc-svelte-mcp", ""]
	}
}

替换 `` 使用您的Q-SYS核心IP地址。

要禁用Svelte特定资源，请执行以下操作：

{
	"qrwc-svelte": {
		"command": "npx",
		"args": ["-y", "qrwc-svelte-mcp", "", "--no-svelte"]
	}
}

其他客户

如果我们没有包括您正在使用的MCP客户端，请参阅他们的文档 stdio 服务器和使用 npx 作为命令 -y qrwc-svelte-mcp 作为论点。您可以选择添加 --no-svelte 作为禁用Svelte特定功能的额外参数。

可用工具

MCP服务器提供以下工具：

get_components

获取Q-SYS核心上当前可用的组件列表。

输入：无

输出:

• success：布尔值，指示请求是否成功
• error：可选错误消息
• data：组件对象数组，包含：

- name：组件名称 - controlCount：组件中的控件数量

get_controls

获取组件上的所有控件，包括控件的类型和读/写方向。

输入:

• componentName：要列出控件的组件的名称。使用 get_components 获取组件名称列表的工具。

输出:

• success：布尔值，指示请求是否成功
• error：可选错误消息
• data：控制对象数组，包含：

- name：控件名称 - type：控件类型（例如，“布尔”、“整数”、“浮点”、“字符串”） - direction：控制方向（“读取”、“写入”或“读写”）

可用提示

qrwc-task

执行涉及创建或修改Q-SYS设计中UI元素的任务。此提示确保常见的Q-SYS术语和qrwc轻量级知识在上下文窗口中。

参数:

• task：要执行的任务的描述

备注：此提示仅在不使用时可用 --no-svelte 旗帜。

可用资源

以下资源可用于提供使用qrwc-svelte的文档和示例：

static://qrwc-svelte/setup

QRWC与Svelte项目的初始设置和配置指南。

static://qrwc-svelte/core-concepts

使用Q-SYS系统和QRWC协议的核心概念和术语。

static://qrwc-svelte/components

在Svelte项目中使用Q-SYS组件的文档，包括组件实例化和使用。

static://qrwc-svelte/controls

关于使用Q-SYS控制的文档，包括如何读取和写入控制值。

static://qrwc-svelte/button-examples

使用布尔控件（按钮、开关等）的示例代码。

static://qrwc-svelte/knob-examples

使用Integer、Float和其他数字类型控件（旋钮、滑块等）的示例代码。

static://qrwc-svelte/text-examples

使用基于文本/字符串的控件的示例代码。

备注：所有资源仅在不使用时可用 --no-svelte 旗帜。

使用示例

基本用法

连接到IP地址的Q-SYS核心 192.168.1.100:

npx -y qrwc-svelte-mcp 192.168.1.100

禁用Svelte特定功能

如果你使用的是不同的UI框架（不是Svelte），你可以禁用Svelte特定的资源和提示：

npx -y qrwc-svelte-mcp 192.168.1.100 --no-svelte

使用时 --no-svelte，只有核心工具(get_components 和 get_controls)可用。所有Svelte特定资源和 qrwc-task 提示已禁用。

如果您正在使用另一个框架，并希望创建自己的提示，指示LLM从Q-SYS Core中获取控件和组件，这将非常有用。

相关链接

• Svelte MCP官方服务器
• Q-SYS文件

许可证

Apache 2.0