🎯 增强型地震编码竞技场-MCP服务器
](https://smithery.ai/server/@Ripnrip/quake-coding-arena)
统治！杰出的！太棒了！势不可挡！ 🎯🔥
高级TypeScript MCP服务器，用于用真实的《雷神之锤3竞技场》声音和双声道播音员将您的开发环境游戏化
🚀 特性
🎮 25项史诗般的成就
- 连胜成绩：斜坡式、统治式、不可阻挡、哥特式（两种声音）
- 质量成就：优秀、完美、令人印象深刻（男声）
- 多人死亡：昏厥、枪击、多杀、超杀、怪物杀、卢迪库斯杀、自杀、双重杀、三重杀（两种声音）
- 游戏事件：第一滴血，受伤，圣洁的衬衫，底部喂食器（两种声音）
- 团体赛：准备战斗，玩（两种声音）
🎤 双语音系统
- 男播音员：包含17种独特声音的完整语音包
- 女播音员：包含16种独特声音的完整语音包
- 智能回退 用男声代替不可用的女声
- 音量控制 (0-100%)
- 跨平台音频 支持
🔧 MCP集成
- 10个MCP工具 完全控制
- JSON-RPC 2.0 顺从的
- 会话统计信息 追踪
- 双重运输支持：HTTP（Smithery）和stdio（本地客户端）
- 克劳德代码兼容 具有自动stdio检测功能
- 类别筛选 成就
- 随机成就 选择
- AI使用指南 整合
- 语音包测试 能力
📦 安装选项
选项1：地方发展设置
# Run local setup script
./setup-local.sh
# Or manually
npm install
npm run build
node run-server.ts选项2：远程（Smithery）部署
⚠️ 重要提示： Smithery包不在npm上——它们使用HTTP端点！
# Run remote setup script
./setup-remote.sh
# Or use Smithery HTTP endpoint directly
# Add to your MCP configuration:
{
"mcpServers": {
"quake-arena": {
"transport": "http",
"url": "https://server.smithery.ai/@Ripnrip/quake-coding-arena-mcp/mcp"
}
}
}注： 对于本地开发/测试，使用本地构建方法（选项1）而不是npx。
选项3:GitHub页面网站
访问现场音板： https://ripnrip.github.io/Quake-Coding-Arena-MCP/
该网站包括：
- ✅ 包含全部25项成就的交互式音板
- ✅ 双语音系统（男/女切换）
- ✅ 类别筛选
- ✅ 音量控制
- ✅ GitHub页面准备就绪
🎯 可用的MCP工具
核心成就工具
play_enhanced_quake_sound-触发特定成就random_enhanced_achievement-按类别随机list_enhanced_achievements-浏览所有成就
控制和设置
set_enhanced_volume-设置音量（0-100）set_voice_pack-切换男声/女声get_voice_pack_info-语音信息
统计与指南
get_enhanced_achievement_stats-会话统计get_enhanced_achievement_guide-成就指南get_ai_usage_guide-特定上下文的使用技巧test_voice_packs-测试所有语音包
🎮 使用示例
// Trigger a GODLIKE achievement at 80% volume
await session.call("tools/call", {
name: "play_enhanced_quake_sound",
arguments: {
achievement: "GODLIKE",
volume: 80,
voiceGender: "female"
}
});
// Get a random quality achievement
await session.call("tools/call", {
name: "random_enhanced_achievement",
arguments: {
category: "quality",
volume: 70
}
});
// Switch to female voice pack
await session.call("tools/call", {
name: "set_voice_pack",
arguments: {
voiceGender: "female"
}
});🔧 配置
服务器自动检测声音文件并支持：
- MP3和WAV 音频格式
- 自定义声音目录
- 语音包管理
- 会话持续
📁 项目结构
quake-coding-arena-enhanced/
├── index.js # Main MCP server
├── package.json # NPM configuration
├── smithery.yaml # Smithery configuration
├── sounds/ # Audio files
│ ├── male/ # Male announcer sounds
│ └── female/ # Female announcer sounds
├── README.md # This file
└── test-mcp-server.cjs # Test utilities🏆 成就类别
🔥 连胜成绩 （两种声音）
- 横冲直撞 （10） -多个快速任务
- 占主导地位 （15） -复杂问题已解决
- 势不可挡 （20） -长时间富有成效的会议
- 神一般的 （25）-传奇编码会话
✨ 质量成就 （男声）
- 优秀 -优雅的解决方案
- 完美 -无瑕疵的实施
- 令人印象深刻的 -创造性解决问题
⚔️ 多杀成就 （两种声音）
- 爆头 -精确编码
- 双杀 -两个速赢
- 多杀 -多个虫子被压扁
- 杀戮狂欢 -持续的生产力
- 三杀 -三倍效率
- 超杀伤 -卓越的性能
- 怪物杀人 -大规模代码重构
- 荒唐的杀戮 -难以置信的解决方案
- 病得很厉害 -令人惊叹的解决方案
🎪 游戏状态公告 （两种声音）
- 第一滴血 -发现第一个bug
- 羞辱 -快速修复错误
- 卧槽 -意想不到的突破
- 乘人之危谋利的人 -从错误中学习
👥 团体赛 （两种声音）
- 准备战斗 -团队激励
- 播放 -游戏开始了，让我们编码吧！
🎯 非常适合
- 开发者 想要游戏化的编码环境
- 团队 需要激励性反馈
- 主播 想要吸引人的内容
- 教育工作者 编码概念教学
- 任何人 爱地震3竞技场怀旧！
📊 需求
- Node.js 18+ 对于MCP服务器
- MCP兼容 IDE（光标、克劳德桌面等）
- 音频系统 用于声音播放
🔗 集成示例
克劳德桌面版
{
"mcpServers": {
"quake-arena": {
"command": "npx",
"args": ["@Ripnrip/quake-coding-arena-mcp"]
}
}
}光标/克劳德代码
- 本地构建方法 （推荐）：
{
"mcpServers": {
"quake-coding-arena": {
"command": "node",
"args": ["/path/to/.smithery/index.cjs"]
}
}
}- HTTP端点方法 （服务器运行时）：
{
"mcpServers": {
"quake-coding-arena": {
"transport": "http",
"url": "http://localhost:6487/mcp"
}
}
}- 看
CLAUDE-CODE-SETUP.md和CURSOR-HTTP-SETUP.md详细说明
聊天小部件+声桥
克隆就绪示例，代理ChatGPT响应并调用此MCP服务器播放Quake成就。看 examples/chat-widget 有关设置说明（需要OpenAI密钥+MCP URL）。
📜 许可证
MIT许可证-随意使用和修改！
🎯 开始使用
- 安装:
smithery install quake-coding-arena-enhanced - 配置：添加到您的MCP客户端
- 实现：开始触发那些史诗般的声音！
🏆 准备好主宰编码领域了！ 🎯🔥
______________________________________________________________________
*内置于❤️ 《雷神之锤3》竞技场怀旧* *通过Smithery发布-MCP服务器注册表*
📝 最新动态
2025年12月10日-JSON解析修复和传输支持
- 🔧 修复JSON解析错误 与Claude Code和其他基于stdio的MCP客户端一起使用时
- 📡 添加了stdio传输支持 具有本地MCP客户端的自动检测功能
- 🚫 固定控制台日志干扰 通过将所有日志重定向到stderr（防止JSON-RPC协议问题）
- ✅ 经过测试和验证 具有HTTP和stdio传输的声音播放功能
- 📚 创建了全面的设置指南:
- CLAUDE-CODE-SETUP.md -完整的Claude代码集成指南 - CURSOR-HTTP-SETUP.md -游标IDE HTTP端点设置 - CURSOR-SETUP-COMPLETE.md -光标MCP配置指南
- 🔌 双重运输支持：服务器现在可以使用HTTP（Smithery）和stdio（本地客户端）
- 🎯 端口冲突处理 具有自动端口选择和交互式提示功能
2025年12月10日-女性音频扩展更新
- 🎤 添加了16个女声音频文件 到
sounds/female/目录 - 🏆 已扩展至25项总成就 具有全面的多重杀伤支持
- 🔄 更新了语音包配置 正确指向女性音频目录
- 📚 增强文档 反映女性新的音频能力
- 🔧 修复了TypeScript构建问题 并提高了导入分辨率
- ✅ 完全兼容性 保留现有的男声功能
新的女性音频包括：
- 经典连胜公告（斜坡、统治、不可阻挡、GODLIKE）
- 多杀序列（头部射击、多杀、杀死喷雾、超杀、怪物杀、卢迪库斯杀）
- 游戏状态公告（第一滴血、伤害、圣洁衬衫、底部喂食器）
- 团队激励之声（播放）
技术改进：
- 智能回退系统为男性声音寻找缺失的女性音频
- 增强成果分类，共有25项成果
- 更新了MCP工具说明和文档
- 经过验证的跨平台音频兼容性
______________________________________________________________________
*内置于❤️ 《雷神之锤3》竞技场怀旧* *通过Smithery发布-MCP服务器注册表*
🌐 Smithery云部署
当通过Smithery部署时，MCP服务器作为云服务运行 HTTP端点。所有音频文件（包括16个女声文件）均通过 package.json “文件”数组。
📖 详细指南： 看 微笑深度.md 获取完整的部署文档。
音频在云模式下的工作原理：
- ✅ 全部25项成就 可提供男声/女声
- ✅ 16个女性+17个男性音频文件 由Smithery自动捆绑
- ✅ 语音包切换 通过
set_voice_pack工具 - ✅ 音量控制 通过
set_enhanced_volume工具 - ✅ 完整的声音库 包含在部署中（通过package.json“files”数组）
- ⚠️ 需要显式工具调用 -调用MCP工具时播放音频
- 🎯 音频在本地播放 -Smithery通过系统命令触发用户机器上的播放
云与本地差异：
- 本地：可以通过文件系统事件自动触发声音
- 云：声音仅在用户/AI明确调用MCP工具时播放
- 两者：相同的成就系统、语音包和音质
- 两者：所有16个女性音频文件可用
通过Smithery使用女声：
// Switch to female voice pack
await session.call("tools/call", {
name: "set_voice_pack",
arguments: { voiceGender: "female" }
});
// Play female achievement
await session.call("tools/call", {
name: "play_enhanced_quake_sound",
arguments: {
achievement: "HEADSHOT",
volume: 85
}
});