ptna-enc-mcp
Enables normalization of musical piece and composer names by searching the Pitina Piano Piece Encyclopedia, returning official titles, composer names, opus numbers, and performance times.
README
ピティナ・ピアノ曲事典 MCP サーバー
ピティナ・ピアノ曲事典 を「正典（マスター）」として、 コンサート・プログラムの曲名・作曲家名の表記揺れを校正するための MCP サーバー。
曖昧な曲名を投げると、本家の正式タイトル・作曲家名・作品番号・演奏時間が返る。
ℹ️ ピティナ非公式の個人ツールです。曲事典の解説文などの著作権はピティナ／原著作者に帰属します。 個人利用・校正はOKですが、出力の転載や大量アクセスはしないでください。
できること（ツール）
| ツール | 用途 |
|---|---|
search_pieces(keyword, limit=20) |
曲名/作曲家のキーワードで楽曲検索。正式タイトル・作曲家・opus・演奏時間・曲IDの候補一覧（校正の中心） |
get_piece(piece_id) |
楽曲IDから詳細（正式タイトル・原題・opus・解説冒頭） |
search_composers(name, limit=20) |
作曲家名の正式表記・IDを検索 |
get_composer(composer_id) |
作曲家プロフィール＋作品リスト |
校正の使い方（例）
プログラムに「ブルグミュラー 貴婦人の乗馬」とある →
search_pieces("ブルグミュラー 貴婦人の乗馬") →
正式タイトル 25の練習曲 貴婦人の乗馬、作曲家 ブルクミュラー（ブルグミュラー）、
作品番号 Op.100-25 が返る。これを正典として採用。
セットアップ
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 # パーサ単体テスト(ネット不要)
設定（環境変数・任意）
| 変数 | 既定 | 意味 |
|---|---|---|
PTNA_ENC_MIN_INTERVAL |
1.5 |
最小リクエスト間隔（秒） |
PTNA_ENC_CACHE_TTL |
86400 |
ページキャッシュ有効期間（秒）。0で無効 |
PTNA_ENC_CACHE_DIR |
~/.cache/ptna-enc-mcp |
キャッシュ保存先 |
PTNA_ENC_USER_AGENT |
ツール名＋連絡先 | 送信 User-Agent |
設計・スクレイピングの方針
- API 非提供のサイトのため HTML スクレイピング。事前クロール／DB は持たず、 TTL キャッシュで「一度見たページを覚える」だけ（運用ゼロ）。
- 都度1件のみ取得し、独自 User-Agent 明示＋リクエスト間隔を守る（礼儀レイヤ）。
- 高度フィルタ（ジャンル/調性/ステップレベル）はサイトが JS 描画するため v1 では未対応。
詳細は docs/superpowers/specs/2026-08-07-ptna-enc-mcp-design.md。
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.