AI导哈

调试游戏化服务器

将调试过程转化为奇幻冒险游戏的MCP服务器，通过游戏化机制提升调试体验和效率。

  • by chrisreddington
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 chrisreddington/my-first-mcp-server

使用说明

🏰 橡胶鸭探险MCP服务器

将您的调试会话转化为史诗般的幻想任务！这个MCP服务器将橡胶躲避调试技术游戏化，将你变成一个英雄般的代码战士，去征服邪恶的bug。

🎮 这是什么？

橡皮鸭探险MCP服务器是一个独特的调试伴侣，它：

  • 游戏化调试 -将令人沮丧的虫子狩猎变成引人入胜的幻想冒险
  • 未解决的指南 -帮助你用苏格拉底式方法思考问题
  • 提供动力 -史诗般的幻想主题使调试更加愉快
  • 跟踪进度 -当你征服更具挑战性的虫子时，看着你的英雄升级
  • 鼓励系统思考 -结构化的任务阶段指导您的调试方法

🐉 Bug分类

不同类型的虫子会变成不同的幻想生物：

  • 🧌 地精 -小错误、拼写错误、简单的逻辑错误
  • ⚔️ 兽人 -中度错误、集成问题
  • 👹 巨魔 -复杂的错误、性能问题
  • 🐉 龙 -关键错误、系统崩溃问题
  • 🐍 九头蛇 -具有多种根本原因的多方面错误

🗡️ 任务类型

您的调试冒险分为不同的任务类型：

  • 逻辑探索 -算法和逻辑错误
  • 性能探索 -优化和速度问题
  • 集成任务 -API和服务集成问题
  • UI任务 -用户界面和样式挑战
  • 数据查询 -数据库和数据处理问题
  • 建筑探索 -系统设计和结构问题

🚀 可用工具

start_quest

通过描述你的bug开始新的调试冒险。该系统将：

  • 将你的bug严重程度分类（妖精到龙）
  • 确定任务类型
  • 设置一个冒险故事
  • 提供初步指导性问题

参数：

  • description -你面对的是什么bug？
  • techStack （可选）-涉及的技术
  • urgency （可选）-这个问题有多重要？

continue_quest

通过分享发现和发现，在探索中取得进展。

参数：

  • finding -你发现、尝试或学到了什么
  • significance （可选）-这一发现有多重要？

get_quest_status

查看您当前的任务进度、英雄统计数据和调试旅程。

seek_wisdom

询问有关调试方法、测试策略或调查技术的具体指导。

参数：

  • helpType -所需的指导类型（例如，“方法”、“测试”、“调查”）

complete_quest

当你解决了这个bug时，庆祝你的胜利！

参数：

  • solutionSummary （可选）-您如何解决问题

🎭 冒险音调一致性

adventure-tone-guide 提示

此服务器包含一个特殊提示，提供 自动音调一致性引导 连接到它的任何AI助手。当AI客户端访问 adventure-tone-guide 提示，它会收到全面的指示，在所有调试交互中保持幻想冒险主题。

它提供了什么：

  • ⚔️ 所需的语言模式（bug如“妖精”、“龙”等）
  • 🏰 幻想术语指南
  • 🎯 沟通风格要求
  • ✨ 要使用的短语和表情符号示例
  • 🧙‍♂️ 明智的导师人格指导

这确保了 每次调试会话都感觉像是一次史诗般的冒险，无论服务器部署在哪个王国（存储库）！

🎯 哲学

此服务器遵循核心的躲避原则：

  1. 从不提供直接解决方案 -引导您自己发现答案
  2. 提出深思熟虑的问题 -帮助您系统地思考问题
  3. 鼓励探索 -支持不同的方法和观点
  4. 庆祝进步 -承认突破和学习时刻
  5. 让调试变得有趣 -幻想主题减少挫折感，提高参与度

🛠️ 设置

先决条件

  • Node.js 18+
  • npm或纱线

安装

  1. 克隆存储库：
git clone https://github.com/chrisreddington/my-first-mcp-server.git
cd my-first-mcp-server
  1. 安装依赖项：
npm install
  1. 构建项目：
npm run build

跑步

npm run start

与Claude Desktop集成

将此配置添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "rubber-ducking-adventure": {
      "command": "node",
      "args": ["/absolute/path/to/my-first-mcp-server/build/index.js"]
    }
  }
}

配置文件位置：

  • macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json

VS代码调试

此项目包括用于调试的VS代码配置：

  1. 在VS Code中打开项目
  2. 转到运行和调试面板（Ctrl/Cmd+Shift+D）
  3. 运行“构建并运行MCP服务器”任务

🎮 用法示例

  1. 开始一个任务：

    Tool: start_quest
Description: "My React component isn't re-rendering when state changes"
Tech Stack: ["React", "TypeScript", "Vite"]
Urgency: "moderate"

  2. 继续调查结果：

    Tool: continue_quest  
Finding: "I added console.logs and the state is definitely updating"
Significance: "moderate"

  3. 寻求具体指导：

    Tool: seek_wisdom
Help Type: "testing"

  4. 完成任务：

    Tool: complete_quest
Solution Summary: "The issue was a missing key prop causing React to not recognize the component should re-render"

🏆 英雄进步

  • 通过完成任务获得经验值（XP）
  • 升级你的调试英雄
  • 追踪你的任务完成历史
  • 通过系统性的成功建立信心

🛠️ 发展

项目结构

rubber-ducking-adventure-mcp/
├── src/
│   ├── index.ts              # Main server implementation
│   ├── adventureEngine.ts    # Core quest and adventure logic
│   ├── questTypes.ts         # TypeScript interfaces and enums
│   └── mentorResponses.ts    # Response templates and guidance
├── build/                    # Compiled JavaScript (generated)
├── .vscode/
│   ├── mcp.json             # MCP server configuration
│   └── tasks.json           # VS Code tasks
├── package.json
├── tsconfig.json
└── README.md

可用脚本

  • npm run build -将TypeScript编译为JavaScript
  • npm run start -构建并运行服务器
  • npm run dev -开发模式（与启动模式相同）

技术细节

📚 冒险仍在继续

每个调试会话都成为您英雄之旅的一部分。你完成的任务越多，你的调试技能就越强，面对未来的挑战就越有信心。

记住：每个主调试器都曾经是一个从不放弃的初学者！

🤝 贡献

这是一个演示游戏化调试和MCP服务器开发的学习项目。请随意分叉和实验！

📄 许可证

ISC许可证-有关详细信息，请参阅许可证文件。

🙏 致谢

  • 模型上下文协议 对于规范
  • MCP-SDK 发展框架
  • 启发系统解决问题的橡胶回避调试技术
  • 梦幻RPG游戏的冒险和进展机制

准备好开始调试之旅了吗？数字领域等待您的英勇努力！ ⚔️🐉

相关 MCP