Pd MCP Server

🚀 純データMCPサーバ

このプロジェクトは、モデルコンテキストプロトコル（MCP）を通じて、Claude AIとPure Dataの統合を実現しています。この統合により、Claudeは自然言語処理を通じて、Pure Dataのパッチを動的に作成、修正、制御することができます。

🔍 既知の問題

⚠️ 重要提示

サンプルパッチ (example patch.pd) は現在正常に動作しません。

📋 概要

このシステムは3つの核心コンポーネントで構成されています。

1. MCPサーバ（mcp_server.py）：Claudeのモデルコンテキストプロトコルインターフェースを実装します。
2. OSCデーモン（osc_daemon.py）：Pure DataとのOSC通信を処理します。
3. Pure Dataパッチ（absolute_final_solution.pd）：OSCメッセージを受信する動的パッチソリューションです。

✨ 主な機能

• 動的オブジェクト作成：Claudeを通じて必要に応じて任意のPure Dataオブジェクトを作成します。
• 接続管理：オブジェクトを接続して複雑な信号フローを構築します。
• DSP制御：リモートでオーディオ処理を開始および停止します。
• パラメータ制御：オブジェクトのパラメータをリアルタイムで変更します。
• グローバルオブジェクト追跡：信頼性の高いインデックスベースの接続システムです。
• エラー処理：強力なエラー検出と報告機能を備えています。
• デバッグツール：包括的なログ記録システムです。

📦 インストール

前提条件

• Python 3.7以上
• Pure Data（ネイティブ）0.51以上
• 必要なPythonパッケージ：
  • python-osc
  • fastmcp
  • jsonschema
• uv パッケージマネージャー

uv のインストール

macOSとLinux：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

詳細はこちら：astral-sh/uv

🛠️ 使用例

リポジトリのクローン

git clone https://github.com/nikmaniatis/Pd-MCP-Server.git

Claude Desktopとの統合

1. 以下を開きます： Claude > 設定 > 開発者 > 設定の編集 > claude_desktop_config.json
2. 以下のコードブロックを追加します：

{
    "mcpServers": {
      "Pure Data MCP Server": {
        "command": "uv",
        "args": [
          "--directory",
          "PATH_TO_PD_MCP_SERVER",
          "run",
          "main.py"
        ],
        "env": {
          "PD_OSC_HOST": "127.0.0.1",
          "PD_OSC_PORT": "5000",
          "PD_FEEDBACK_PORT": "5001"
        }
      }
    }
  }

⚠️ 重要提示

uv コマンドが見つからない場合は、which uv（Unix）または Get-Command uv（PowerShell）を実行し、"command" フィールドに完全なパスを使用してください。

🔧 技術詳細

メッセージフロー

1. Claudeがユーザーのリクエストに基づいてMCPツールを実行します。
2. MCPサーバがツールの呼び出しを処理します。
3. OSCメッセージをフォーマットしてPure Dataに送信します。
4. Pure Dataが動的パッチを通じてコマンドを実行します。
5. フィードバック（ある場合）がOSCコールバックを通じて返されます。

トラブルシューティング

一般的な問題

1. オブジェクト作成失敗：Pure Dataが実行中で、パッチが開かれていることを確認してください。
2. 接続問題：オブジェクトIDが create_object の返り値と完全に一致していることを確認してください。
3. ポート競合：5000番ポートが使用中でないことを確認してください。
4. メッセージ形式エラー：メッセージ形式がPure Dataパッチで期待される形式と一致していることを確認してください。
5. オブジェクトが見つからない：オブジェクトの追跡が混乱している場合は、MCPサーバとPure Dataを再起動してください。

JSONスキーマ

pd-schema.json は、Pure Dataパッチ用の包括的なデータモデルを提供し、パッチの検証とシリアル化をサポートしています。現在のMCPツールでは使用されていませんが、AIツールの実装における重要なプロトコルです。

📄 ライセンス

• Pure Data - オープンソースの可視化プログラミング言語
• モデルコンテキストプロトコル - AIツールを有効にするプロトコル
• Python-OSC - Pythonで実装されたOSC