Zaparoo MCP

Zaparoo MCP

一 主控程序 控制服务器 扎帕罗奥 设备，允许AI助手与Zaparoo进行交互。

快速开始

npx -y zaparoo-mcp

默认情况下，本地网络上的设备是通过mDNS自动发现的。要手动指定设备，请执行以下操作：

npx -y zaparoo-mcp --devices 192.168.1.100

配置

克劳德代码

claude mcp add zaparoo -- npx -y zaparoo-mcp

手动设备配置：

claude mcp add zaparoo --env ZAPAROO_DEVICES=192.168.1.100 -- npx -y zaparoo-mcp

克劳德桌面

添加到您的 claude_desktop_config.json:

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

法典

codex mcp add zaparoo -- npx -y zaparoo-mcp

或添加到 ~/.codex/config.toml:

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

开爪

openclaw mcp set zaparoo '{"command":"npx","args":["-y","zaparoo-mcp"]}'

光标

添加 .cursor/mcp.json:

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

VS Code

添加 .vscode/mcp.json:

{
  "servers": {
    "zaparoo": {
      "command": "npx",
      "args": ["-y", "zaparoo-mcp"]
    }
  }
}

双子星命令行工具

添加 ~/.gemini/settings.json:

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

选项

默认情况下，服务器使用mDNS在本地网络上发现Zaparoo设备。如果您的设备位于同一网络上，则不需要进行配置。

要手动指定设备，请使用CLI参数或环境变量。CLI参数优先。

如果未指定，默认端口为7497。手动指定设备时，mDNS发现功能将被禁用。

特性

工具

资源

• zaparoo://devices --所有连接的设备状态
• zaparoo://{deviceId}/state --每个设备状态（读取器、活动媒体、令牌）
• zaparoo://reference/zapscript --ZapScript语言参考

提示

• 写入NFC标签 --搜索游戏并将其写入NFC标签
• 查找并启动游戏 --搜索您的库并启动游戏
• 创建令牌映射 --将NFC令牌扫描映射到操作
• 查看播放历史记录 --游戏统计和最近的活动
• 玩什么？ --所有设备的快速状态仪表板
• 探索游戏库 --浏览游戏，获取推荐，发现隐藏的宝石
• ZapScript帮助 --帮助编写ZapScript命令

先决条件

• Node.js 22+
• 一个或多个 Zaparoo核心 网络上可访问的设备

发展

git clone https://github.com/ZaparooProject/zaparoo-mcp.git
cd zaparoo-mcp
npm install
npm run build

许可证

该项目根据 GNU通用公共许可证v3.0 或稍后。