**Show HN:** *エージェント用オーディオ・ツールキット*

SAS Audio Processor（サス・オーディオ・プロセッサ）

「Signals & Sorcery（シグナルズ＆ソーサリー）」という音楽制作アプリケーションのコンポーネント。

25 個のオーディオ処理ツール（トリム、ノーマライズ、コンプレッション、EQ、リバーブ、ピッチシフト、タイムストレッチ、キー検出、MIDI抽出など）を DeclarAgent 経由で MCP ツールとして公開しています。

何が得られるか

すべてのツールは WAV ファイルを入力として受け取り、構造化された JSON を出力します。

クイックスタート（Claude Code）

1. DeclarAgent のインストール

   go install github.com/stevehiehn/declaragent@latest
   

2. sas‑audio‑processor のインストール

   ソースから:

   git clone https://github.com/stevehiehn/sas-audio-processor.git
   cd sas-audio-processor
   python3 -m venv venv && source venv/bin/activate
   pip install -r requirements.txt && pip install -e .
   

   あるいは、事前にビルドしたバイナリ（macOS のみ）:

   ./build.sh
   # バイナリ: dist/sas-processor/sas-processor
   

3. MCP 設定の追加

   ~/.claude/settings.json

   に追記:

   {
     "mcpServers": {
       "sas-audio": {
         "command": "declaragent",
         "args": ["--plans-dir", "/path/to/sas-audio-processor/plans"]
       }
     }
   }
   

4. 使用例

   You: Analyze this drum loop and tell me the BPM
   Claude: [calls analyze tool] The drum loop is at 128 BPM, 44100 Hz, stereo, 8.2 s long.
   
   You: Trim it to 4 bars and normalize to -14 LUFS
   Claude: [calls trim → normalize] Done — trimmed to 4 bars starting at the downbeat, normalized to -14 LUFS.
   
   You: Now master it
   Claude: [calls master‑track] Applied normalize → compress → limit chain. Output saved.
   

クイックスタート（その他の MCP クライアント）

• Claude Desktop

  claude_desktop_config.json

  に追記:

  {
    "mcpServers": {
      "sas-audio": {
        "command": "declaragent",
        "args": ["--plans-dir", "/path/to/sas-audio-processor/plans"]
      }
    }
  }
  

• Cursor / Windsurf / Copilot

  同じ MCP サーバー設定をエディタの MCP 設定に追加します。
  コマンドと引数は同一で、ファイル位置のみ異なります。

動作概要

MCP Client (Claude Code, Claude Desktop 等)
    │
    └─► DeclarAgent (plans ディレクトリ内の YAML を読み込み)
            │
            └─► sas-processor <subcommand> --input … --output …
                    │
                    └─► stdout: JSON 結果

plans/

sas-processor

利用可能なツール

Processing（処理）

Effects（エフェクト）

Analysis（解析）

MIDI

Composite（マルチステップ）

CLI リファレンス

すべてのサブコマンドは行区切り JSON を stdout に出力し、エラーは stderr に JSON として送出します。

sas-processor <subcommand> [options]

ping

ヘルスチェック — バージョンとステータスを返す。

analyze

sas-processor analyze --input <file>

trim

sas-processor trim --input <file> --output <file> --bpm <float> --bars <int> [--meter 4] [--verbose]

time‑stretch

sas-processor time-stretch --input <file> --output <file> --source-bpm <float> --target-bpm <float>

normalize

sas-processor normalize --input <file> --output <file> [--mode lufs|peak] [--target-lufs -14] [--target-peak -1]

gain

sas-processor gain --input <file> --output <file> --db <float>

mono

sas-processor mono --input <file> --output <file>

convert

sas-processor convert --input <file> --output <file> [--sample-rate <int>] [--bit-depth 16|24|32]

silence‑remove

sas-processor silence-remove --input <file> --output <file> [--top-db 30]

compress

sas-processor compress --input <file> --output <file> [--threshold -20] [--ratio 4] [--attack 1.0] [--release 100]

eq

sas-processor eq --input <file> --output <file> --freq <float> --gain-db <float> [--q 1.0]

reverb

sas-processor reverb --input <file> --output <file> [--room-size 0.5] [--damping 0.5] [--wet-level 0.33]

limit

sas-processor limit --input <file> --output <file> [--threshold -1]

filter

sas-processor filter --input <file> --output <file> --type highpass|lowpass --cutoff-hz <float>

pitch‑shift

sas-processor pitch-shift --input <file> --output <file> --semitones <float>

detect-key

sas-processor detect-key --input <file>

loudness

sas-processor loudness --input <file>

onset‑detect

sas-processor onset-detect --input <file>

split-bars

sas-processor split-bars --input <file> --output-dir <dir> --bpm <float> [--bars-per-chunk 1] [--meter 4]

melody‑to‑midi

sas-processor melody-to-midi --input <file> --output <file.mid>

ソースからビルド

前提条件

• macOS 10.15+
• Python 3.9+

手順

git clone https://github.com/stevehiehn/sas-audio-processor.git
cd sas-audio-processor
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt && pip install -e .

自己完結型バイナリ:

pyinstaller sas-processor.spec --clean --noconfirm
# 出力先: dist/sas-processor/

クロスアーキテクチャビルド（Apple Silicon & Intel）:

# Apple Silicon (ARM64)
pyinstaller sas-processor.spec --clean --noconfirm
mv dist/sas-processor dist/sas-processor-arm64

# Intel (x86_64)
arch -x86_64 /bin/bash -c "
  python3 -m venv venv-x64
  source venv-x64/bin/activate
  pip install -r requirements.txt
  pyinstaller sas-processor.spec --clean --noconfirm
"
mv dist/sas-processor dist/sas-processor-x86_64

テスト実行

source venv/bin/activate

# 全テスト
pytest tests/ -v

# E2E サブコマンドテストのみ
pytest tests/test_plans_e2e.py -v

# カバレッジ付き
pytest tests/ -v --cov=sas_processor

JSON 出力形式

すべてのサブコマンドは行区切り JSON を stdout に出力します。

Result (stdout)

{"type":"<subcommand>","success":true,"output":"/path/to/output.wav",…}

Progress Events（trim のみ、stdout）

{"type":"progress","stage":"loading","percent":0}
{"type":"progress","stage":"detecting","percent":30}
{"type":"progress","stage":"trimming","percent":60}
{"type":"progress","stage":"complete","percent":100}

Errors (stderr)

{
  "type":"error",
  "code":"FILE_NOT_FOUND",
  "message":"Input file not found: /path/to/file.wav",
  "severity":"fatal"
}

制限事項

• WAV のみ – MP3、FLAC 等のフォーマットは非対応。
• バイナリビルドは macOS 限定（CLI は Python が動く環境ならどこでも使用可）。
• バイナリサイズは NumPy/Scipy/Librosa 依存で約 220 MB。

ライセンス: MIT