MCP Audacity

🚀 審音 MCP サーバー

このプロジェクトは、mod‑script‑pipe インターフェースを介して Audacity に接続する MCP（モデルコンテキストプロトコル）サーバーを実装しています。名前付きパイプを使用して、サーバーは Audacity にコマンドを送信し、応答を受け取ります。これにより、MCP ターミナルを通じて Audacity を制御できます（例：録音の開始/停止や再生など）。サーバーは uv ツールを使用して実行でき、Claude Desktop クライアントと統合することもできます。

🚀 クイックスタート

このセクションでは、審音 MCP サーバーの概要と基本的な使い方を説明します。このサーバーを使用することで、Audacity を MCP ターミナルから制御できます。

✨ 主な機能

• Audacity 統合: mod‑script‑pipe インターフェースを使用して、名前付きパイプを介して Audacity と通信します。
• MCP ターミナル: 以下の MCP ツールターミナルを提供します。
  • Audacity の状態を取得します。
  • 録音の開始と停止を行います。
  • 再生と一時停止を行います。
• uv 統合: uv ツールを使用して MCP サーバーを実行します。
• Claude Desktop 互換性: Claude Desktop クライアントを使用して起動するように設定できます。

📦 インストール

必要条件

• Audacity バージョン: 推奨バージョンは 3.x 以上です。
• Python バージョン: 3.13 以上が必要です。
• uv ツール: MCP サーバーを実行するために必要です。
• mod‑script‑pipe: Audacity のリモート制御/スクリプトインターフェースを有効にする必要があります。
• Python 依存関係: このプロジェクトには以下のパッケージが必要です。
  • httpx
  • mcp[cli]

インストール手順

1. プロジェクトのクローンまたはダウンロード:

   git clone <repository-url>
   cd mcp-audacity
   

2. 仮想環境の設定:
   • uv ツールを使用して仮想環境を作成し、アクティブ化します。

   uv venv --python=python3.13
   source .venv/bin/activate
   

3. 依存関係のインストール
   • 必要な依存関係をインストールします。

   uv add "mcp[cli]" httpx
   

4. プロジェクト構造の検証
   プロジェクトフォルダに以下のファイルが含まれていることを確認してください。
   • audacity_mcp_pipe.py（メインの MCP サーバースクリプト）
   • pyproject.toml（プロジェクト設定）
   • （オプション）claude_desktop_config.json（Claude Desktop との統合が必要な場合）

📚 ドキュメント

Audacity の設定

Claude Desktop クライアントを使用してサーバーを実行する場合は、claude_desktop_config.json を更新してこのプロジェクトを指すようにしてください。例えば：

{
    "mcpServers": {
        "audacity": {
        "command": "/%absolute_path_to_ev%/.local/bin/uv",
        "args": [
            "--directory",
            "/Users/andriiboboshko/mcp-audacity",
            "run",
            "audacity_mcp_pipe.py"
        ]
        }
    }
}

パスがプロジェクトの位置と一致し、仮想環境が正しく設定されていることを確認してください。

使用方法

エラー対応

• エラー: spawn uv ENOENT
  • MCP サーバーが uv を起動しようとしたときに、uv が PATH にあるにもかかわらずプロセスを作成できない場合にこのエラーが発生します。Claude Desktop の設定 claude_desktop_config.json に絶対パスを追加すると、問題が解決します。
• ERROR - Failed to connect to Audacity: [Errno 61] Connection refused
  • Audacity が /tmp フォルダ内にいくつかの数字を使用してコマンドと応答のパイプファイルを作成するため、このエラーが発生します。

  /tmp/audacity_script_pipe.to.501
  /tmp/audacity_script_pipe.from.501
  

  • コード内で特定の数字に更新すると、問題が解決します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。自由に修正し、配布することができます。