Zaparoo MCP
一 主控程序 控制服务器 扎帕罗奥 设备,允许AI助手与Zaparoo进行交互。
快速开始```bash
npx -y zaparoo-mcp
默认情况下,本地网络上的设备是通过mDNS自动发现的。要手动指定设备,请执行以下操作:```bash
npx -y zaparoo-mcp --devices 192.168.1.100
配置
克劳德代码```bash
claude mcp add zaparoo -- npx -y zaparoo-mcp
手动设备配置:```bash
claude mcp add zaparoo --env ZAPAROO_DEVICES=192.168.1.100 -- npx -y zaparoo-mcp
克劳德桌面
添加到您的 claude_desktop_config.json:```json
{
"mcpServers": {
"zaparoo": {
"command": "npx",
"args": ["-y", "zaparoo-mcp"]
}
}
}
### 法典```bash
codex mcp add zaparoo -- npx -y zaparoo-mcp
或添加到 ~/.codex/config.toml:```toml
[mcp_servers.zaparoo]
command = "npx"
args = ["-y", "zaparoo-mcp"]
### 开爪```bash
openclaw mcp set zaparoo '{"command":"npx","args":["-y","zaparoo-mcp"]}'
光标
添加 .cursor/mcp.json:```json
{
"mcpServers": {
"zaparoo": {
"command": "npx",
"args": ["-y", "zaparoo-mcp"]
}
}
}
### VS Code
添加 `.vscode/mcp.json`:```json
{
"servers": {
"zaparoo": {
"command": "npx",
"args": ["-y", "zaparoo-mcp"]
}
}
}
双子星命令行工具
添加 ~/.gemini/settings.json:```json
{
"mcpServers": {
"zaparoo": {
"command": "npx",
"args": ["-y", "zaparoo-mcp"]
}
}
}
## 选项
默认情况下,服务器使用mDNS在本地网络上发现Zaparoo设备。如果您的设备位于同一网络上,则不需要进行配置。
要手动指定设备,请使用CLI参数或环境变量。CLI参数优先。
|设置|CLI参数|环境变量|
| ------------ | ------------------------------------- | ------------------------ |
|设备| `--devices host:port[,host:port,...]` | `ZAPAROO_DEVICES` |
|API密钥| `--keys key1[,key2,...]` | `ZAPAROO_KEYS` |
|未发现| `--no-discovery` | `ZAPAROO_NO_DISCOVERY=1` |
如果未指定,默认端口为7497。手动指定设备时,mDNS发现功能将被禁用。
## 特性
### 工具
|类别|工具|
|-------------------|---------------------------------------------------------------------------------------------------------------------------------|
|发射与控制| `zaparoo_run`, `zaparoo_stop`, `zaparoo_media_control`, `zaparoo_input` |
|媒体库| `zaparoo_media`, `zaparoo_media_index`, `zaparoo_systems` |
|NFC和代币| `zaparoo_readers`, `zaparoo_readers_write`, `zaparoo_tokens`, `zaparoo_mappings` |
|设备管理| `zaparoo_devices`, `zaparoo_settings`, `zaparoo_settings_update`, `zaparoo_admin`, `zaparoo_admin_manage`, `zaparoo_screenshot` |
|监测| `zaparoo_notifications`, `zaparoo_logs`, `zaparoo_inbox` |
### 资源
- `zaparoo://devices` --所有连接的设备状态
- `zaparoo://{deviceId}/state` --每个设备状态(读取器、活动媒体、令牌)
- `zaparoo://reference/zapscript` --ZapScript语言参考
### 提示
- **写入NFC标签** --搜索游戏并将其写入NFC标签
- **查找并启动游戏** --搜索您的库并启动游戏
- **创建令牌映射** --将NFC令牌扫描映射到操作
- **查看播放历史记录** --游戏统计和最近的活动
- **玩什么?** --所有设备的快速状态仪表板
- **探索游戏库** --浏览游戏,获取推荐,发现隐藏的宝石
- **ZapScript帮助** --帮助编写ZapScript命令
## 先决条件
- Node.js 22+
- 一个或多个 Zaparoo核心 网络上可访问的设备
## 发展```bash
git clone https://github.com/ZaparooProject/zaparoo-mcp.git
cd zaparoo-mcp
npm install
npm run build
| 命令 | 描述 |
|---|---|
npm run dev |
内置手表模式 |
npm run lint:fix |
自动修复棉绒问题 |
npm run format |
格式代码 |
npm test |
运行测试 |
npm run test:watch |
手表模式下的测试 |
许可证
该项目根据 GNU通用公共许可证v3.0 或稍后。
