ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

让AI自己挑音效:peon-ping MCP Server配置与play_sound实战教程

让AI自己挑音效:peon-ping MCP Server配置与play_sound实战教程 让AI自己挑音效peon-ping MCP Server配置与play_sound实战教程【免费下载链接】peon-pingWarcraft III Peon voice notifications ( more!) for Claude Code, Codex, IDEs, and any AI agent. Stop babysitting your terminal. Employ a Peon today.项目地址: https://gitcode.com/gh_mirrors/pe/peon-pingpeon-ping 的MCP Server是一个面向 AI 智能体的音效工具服务器它通过 Model Context ProtocolMCP把 75 款游戏音效包开放给任意 AI 客户端AI 只需调用一个play_sound工具就能自主判断现在该放哪句台词——构建失败时放一句暴怒的 Duke Nukem读取文件时放一句收到的 Kerrigan。本文带你从零完成配置让 AI 自己挑音效从此告别无意义的固定提示音。为什么需要 peon-ping MCP Server 传统的 peon-ping 用法是钩子hook模式AI 完成任务、请求权限、报错时自动播放固定音效。它稳定但缺少情境感。MCP Server 模式则完全反过来AI 自己挑音效。对比项钩子模式MCP Server 模式音效选择预设固定音效AI 根据上下文自主挑选适用客户端支持 hooks 的 IDE/CLI任意MCP 客户端Claude Desktop、Cursor 等依赖需要 hook 事件无需 hook只需配置 MCP自由度低高AI 可组合多个音效官方在 README.md 中给的例子很生动构建失败时 AI 会调用duke_nukem/SonOfABitch读取文件时调用sc_kerrigan/IReadYou——每句话都是 AI 现场点单的。准备工作安装与依赖MCP Server 只是一个 Node.js 脚本依赖极少核心实现见 mcp/peon-mcp.js依赖声明在 mcp/package.json 中仅需modelcontextprotocol/sdk。环境要求Node.js 18已安装 peon-pingmacOS、Linux 或 WSL2音效包已就位如果还没有安装 peon-ping先 clone 仓库安装git clone https://gitcode.com/gh_mirrors/pe/peon-ping然后在 MCP 目录下安装依赖cd mcp npm install一键配置3步接入 Claude Desktop 与 Cursor配置的核心只有两行用node启动peon-mcp.js。第 1 步定位入口文件入口文件是仓库里的mcp/peon-mcp.js。如果你用 Homebrew 安装路径为$(brew --prefix peon-ping)/libexec/mcp/peon-mcp.js。第 2 步写入 MCP 客户端配置Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json与 Cursor.cursor/mcp.json的配置格式完全一致{ mcpServers: { peon-ping: { command: node, args: [/path/to/peon-ping/mcp/peon-mcp.js] } } }第 3 步重启客户端重启后你的 AI 就多了一个声音遥控器。完整配置说明可参考 mcp/README.md。 提示所有 MCP 客户端通用只需把command和args指向上面的入口脚本即可。play_sound 工具AI 是如何挑音效的 整个 Server 只暴露一个工具play_sound。参数设计很简洁{ sound: duke_nukem/Groovy }或一次连放多句最多 5 句按顺序排队播放{ sounds: [sc_kerrigan/IReadYou, wc2marine/Engage] }关键格式是音效包/音效名例如peon/PeonReady1。AI 调用后会收到明确的结果反馈 播放成功或❌ Not found这让模型能自我纠错——找不到时会去查目录而不是盲目重试。音效目录让 AI看懂全部可用音效AI 怎么知道有哪些音效可选靠的是两个MCP Resource资源端点客户端只读取一次模型即可掌握全量清单不需要反复调工具浏览资源作用peon-ping://catalog完整目录所有音效包及每句音效的名称、标签labelpeon-ping://pack/{name}单个音效包详情按分类列出全部音效目录内容来自本地音效包目录默认~/.openpeon/packs下每个包的openpeon.json清单Server 启动时自动扫描。也就是说你下载的新音效包AI 立刻知道它存在——这正是AI 自己挑音效能成立的基础。音量与目录两个环境变量搞定Server 支持两个环境变量可在 MCP 配置的env字段中设置{ mcpServers: { peon-ping: { command: node, args: [/path/to/peon-ping/mcp/peon-mcp.js], env: { PEON_VOLUME: 0.5 } } } }变量默认值说明PEON_VOLUME0.5播放音量0-1PEON_PACKS_DIR~/.openpeon/packs音效包目录播放层做了完整的平台适配源码中getPlayCommand函数macOS 用afplayLinux 自动在pw-play/paplay/ffplay/mpv等播放器中挑选WSL2 则走 PowerShellSoundPlayer跨平台开箱即用。实战场景让它活起来 配置完成后你可以在提示词中给 AI 定一些音效礼仪效果立刻不同每开始读一批文件放一句确认音 → AI 会挑sc_kerrigan/IReadYou部署成功时放个庆祝音效 → AI 翻目录后会选中合适的胜利台词出错了就放最凶的那句 →duke_nukem/SonOfABitch更进阶的玩法仓库内置了 trainer/ 音效包清单见 trainer/manifest.json包含 Work work!、Peon approve. 等训练模式台词AI 同样可以通过play_sound按trainer包调用给长任务加点仪式感。常见问题速查QAI 提示❌ Not found怎么办A音效名拼写要精确格式必须是包名/音效名。让 AI 先读取peon-ping://catalog资源获取准确清单即可。Q支持 Windows 吗AMCP Server 基于 Node.jsWindows 原生可用音效播放层官方支持 macOS、Linux 与 WSL2。Q和钩子模式冲突吗A不冲突。两者可共存——钩子管固定事件固定音MCP 管AI 即兴发挥一个负责可靠一个负责惊喜。从人定音效到AI 挑音效peon-ping 的 MCP Server 只需一段十几行的 JSON 配置就能接入。配置完成后你的每一个 MCP 客户端 AI 都会多一位随叫随到、声线丰富的小地精解说员。【免费下载链接】peon-pingWarcraft III Peon voice notifications ( more!) for Claude Code, Codex, IDEs, and any AI agent. Stop babysitting your terminal. Employ a Peon today.项目地址: https://gitcode.com/gh_mirrors/pe/peon-ping创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表