ピティナ・ピアノ曲事典 MCP サーバー

ピティナ・ピアノ曲事典 を「正典（マスター）」として、 コンサート・プログラムの曲名・作曲家名の表記揺れを校正するための MCP サーバー。

曖昧な曲名を投げると、本家の正式タイトル・作曲家名・作品番号・演奏時間が返る。

ℹ️ ピティナ非公式の個人ツールです。曲事典の解説文などの著作権はピティナ／原著作者に帰属します。 個人利用・校正はOKですが、出力の転載や大量アクセスはしないでください。

できること（ツール）

校正の使い方（例）

プログラムに「ブルグミュラー 貴婦人の乗馬」とある → search_pieces("ブルグミュラー 貴婦人の乗馬") → 正式タイトル 25の練習曲 貴婦人の乗馬、作曲家 ブルクミュラー（ブルグミュラー）、 作品番号 Op.100-25 が返る。これを正典として採用。

Related MCP server: MusicBrainz MCP Server

セットアップ

cd /Users/miku/ptna-enc-mcp
python3 -m venv .venv
.venv/bin/pip install -e .

Claude Code への登録

claude mcp add ptna-enc -- /Users/miku/ptna-enc-mcp/.venv/bin/ptna-enc-mcp

登録後、Claude Code の会話から「ピティナで『◯◯』の正式表記調べて」と頼めば使える。 確認: claude mcp list に ptna-enc が出ればOK。

動作確認

.venv/bin/python tests/test_parse.py        # パーサ単体テスト(ネット不要)

設定（環境変数・任意）

設計・スクレイピングの方針

• API 非提供のサイトのため HTML スクレイピング。事前クロール／DB は持たず、 TTL キャッシュで「一度見たページを覚える」だけ（運用ゼロ）。

• 都度1件のみ取得し、独自 User-Agent 明示＋リクエスト間隔を守る（礼儀レイヤ）。

• 高度フィルタ（ジャンル/調性/ステップレベル）はサイトが JS 描画するため v1 では未対応。

詳細は docs/superpowers/specs/2026-08-07-ptna-enc-mcp-design.md。