Audacity MCP Server

Audacity MCP サーバー

mod-script-pipe を通じて Audacity を制御するための MCP (Model Context Protocol) サーバーです。

このサーバーは名前付きパイプ経由で Audacity と通信し、多くの Audacity スクリプトコマンドを MCP ツールとして公開します。

機能

• mod-script-pipe 経由で Audacity に接続します
• 幅広い Audacity コマンドを MCP ツールとして公開します
• stdio トランスポートを使用します (Codex/Claude/デスクトップクライアントで動作します)
• /tmp 内のパイプサフィックス (たとえば .501) を自動検出します

要件

• Audacity 3.x 以上
• Python 3.10 以上
• Audacity で mod-script-pipe が有効になっていること

インストール

git clone https://github.com/An-3/mcp-audacity.git
cd mcp-audacity
./scripts/setup.sh

ローカルでのクイックテスト (MCP ホスト不要)

# 1) Start Audacity and enable mod-script-pipe (see section below)
# 2) Verify local connectivity:
./scripts/smoke_test.sh

# 3) Start MCP server:
./scripts/run.sh

スクリプトではなく手動でセットアップしたい場合:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install "mcp[cli]>=1.6.0" "httpx>=0.28.1"

任意 (パッケージ + CLI エントリーポイントとしてインストール):

pip install .
audacity_mcp_server

Audacity で mod-script-pipe を有効にする

1. Audacity を開きます。
2. Modules 設定ページを開きます:
   • Windows/Linux: Edit -> Preferences -> Modules
   • macOS: Audacity -> Settings... -> Modules (ビルドによっては Audacity -> Preferences -> Modules)
3. mod-script-pipe を New (または Disabled) から Enabled に設定します。
4. Audacity を再起動します。

注: 現在の Audacity バージョンでは、これは Modules で設定します。独立した「Scripting/Remote Control」セクションではありません。

パイプが存在することを確認します:

ls -l /tmp/audacity_script_pipe.to.* /tmp/audacity_script_pipe.from.*

ファイルが存在していれば、Audacity は準備完了です。

サーバーを手動で実行する

./scripts/run.sh

起動時のログには以下が含まれます:

• Audacity MCP server starting up
• Opened Audacity mod-script-pipe
• Connected to Audacity mod-script-pipe

Codex から接続する

Codex MCP 設定にサーバーを追加します:

codex mcp add AudacityMCP -- /absolute/path/to/mcp-audacity/.venv/bin/python /absolute/path/to/mcp-audacity/audacity_mcp_server.py

設定済みの MCP サーバーを一覧表示します:

codex mcp list

Claude Desktop から接続する

claude_desktop_config.json の例:

{
  "mcpServers": {
    "audacity": {
      "command": "/absolute/path/to/mcp-audacity/.venv/bin/python",
      "args": [
        "/absolute/path/to/mcp-audacity/audacity_mcp_server.py"
      ]
    }
  }
}

トラブルシューティング

• Failed to open Audacity pipes:
  • Audacity が実行中であることを確認してください。
  • mod-script-pipe が Enabled であることを確認してください。
  • /tmp にパイプファイルが存在することを確認してください。
• spawn uv ENOENT:
  • クライアント設定では絶対パスを使用するか、uv の代わりに上記の Python コマンドを使用してください。
• サーバーは起動するがツールの動作が不安定になる:
  • コマンドを Command: 形式で送信し、BatchCommand finished まで完全な応答を読み取る最新バージョンを使用していることを確認してください。

ライセンス

MIT