Rubber Duck MCP

🚀 アヒルデバッガ MCP サーバー

大規模言語モデル (LLM) 向けの Model Context Protocol (MCP) サーバーで、ラバーダックデバッグツールとして機能します。このサーバーは、LLM が「ラバーダック」と交流し、応答を期待することなく考えを整理し、より効果的にデバッグできるようにします。

✨ 主な機能

• 無言のラバーダック：クラシックなラバーダックデバッグアシスタントで、黙って傾聴し、決して応答しません。
• クリック音のするラバーダック：面白いインタラクティブなラバーダックで、押すと「クリック」という音を発します。

🔧 技術詳細

このサーバーは FastMCP を使用して実装されており、2つの主要なツールを提供します。

1. rubber_duck：伝統的なラバーダックデバッグツールで、黙っています。
2. squeak：インタラクティブなラバーダックで、アクティブになると「Squeak!」と応答します。

📚 ドキュメント

MCP プロトコルを介してこのサーバーに接続することで使用できます。特に以下の用途に適しています。

• 複雑なコードの問題をデバッグする
• 実装ロジックを整理する
• 開発の考え方を整理する
• クリック音機能でデバッグプロセスに楽しみを加える

📦 インストール

前提条件

• 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