Rubber Duck MCP

🚀 鸭子调试器 MCP 服务器

鸭子调试器 MCP 服务器是专为大语言模型 (LLM) 打造的 Model Context Protocol (MCP) 服务器，可作为橡胶鸭调试工具。它能让 LLM 与“橡胶鸭”交流，无需期待回应，有助于 LLM 整理思路，实现更高效的调试。

🚀 快速开始

通过 MCP 协议连接到该服务器即可使用鸭子调试器 MCP 服务器。它特别适用于以下场景：

• 调试复杂代码问题
• 梳理实现逻辑
• 整理开发思路
• 通过嘎吱叫功能为调试过程增添乐趣

✨ 主要特性

• 无声橡胶鸭：经典的橡胶鸭调试助手，默默倾听而从不回应。
• 嘎吱叫橡胶鸭：一个有趣的交互式橡胶鸭，被捏挤时会发出“嘎吱”声。

🔧 技术细节

该服务器使用 FastMCP 实现，并提供两个主要工具：

1. rubber_duck：传统的橡胶鸭调试工具，保持沉默。
2. squeak：交互式的橡胶鸭，激活时会以“Squeak!”作为回应。

📦 安装指南

先决条件

• Python 3.10 或更高版本
• uv 包管理器
• fastmcp 包

要使用该橡胶鸭服务器与 Claude 配合，需通过 FastMCP CLI 进行安装。运行以下命令：

fastmcp install src/server.py

这将使 rubber-duck 对 Claude 通过 MCP 配置文件 claude_desktop_config.json 可用。有关 Claude Desktop 集成的更多细节，请参阅 FastMCP 文档。

安装命令将生成如下 JSON 格式的对象：

{
    "mcpServers": {
      "rubber-duck": {
        "command": "uv",
        "args": [
          "run",
          "--with",
          "fastmcp",
          "fastmcp",
          "run",
          "<project root>/src/server.py"
        ]
      }
    }
}

要在 Cursor 中使用 rubber-duck，请将此 JSON 添加到 <project root>/.cursor/mcp.json。进入 Cursor 设置 > MCP 部分即可看到 rubber-duck 已安装。可能需要重新启动 Cursor 才会显示为绿色。

📄 许可证

MIT License