Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ptna-enc-mcp 「貴婦人の乗馬」の正式タイトルと作曲家名をピティナで調べて"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server for correcting notation inconsistencies in concert program piece names and composer names, using the Ptina Piano Music Encyclopedia as the canonical source.
When you submit an ambiguous piece name, it returns the official title, composer name, opus number, and performance duration from the source.
ℹ️ This is an unofficial personal tool for Ptina. The copyright of the encyclopedia's explanatory texts belongs to Ptina / the original authors. Please use it for personal proofreading only; do not republish the output or make excessive requests.
Tool | Purpose |
| Search for pieces by piece/composer keyword. Returns a list of candidates with official title, composer, opus, duration, and piece ID (core proofreading tool) |
| Retrieve details by piece ID (official title, original title, opus, opening description) |
| Search for composer names in official notation and IDs |
| Retrieve composer profile and list of works |
If a program says "ブルグミュラー 貴婦人の乗馬" →
search_pieces("ブルグミュラー 貴婦人の乗馬") →
returns official title 25の練習曲 貴婦人の乗馬, composer ブルクミュラー（ブルグミュラー）,
opus Op.100-25. Adopt this as the canonical notation.
Related MCP server: MusicBrainz MCP Server
cd /Users/miku/ptna-enc-mcp
python3 -m venv .venv
.venv/bin/pip install -e .claude mcp add ptna-enc -- /Users/miku/ptna-enc-mcp/.venv/bin/ptna-enc-mcpAfter registration, you can use it by asking Claude Code, e.g., "Look up the official notation for '◯◯' in the Ptina encyclopedia."
Check: if ptna-enc appears in claude mcp list, it is ready.
.venv/bin/python tests/test_parse.py # パーサ単体テスト(ネット不要)Variable | Default | Meaning |
|
| Minimum request interval (seconds) |
|
| Page cache validity period (seconds). |
|
| Cache storage location |
| Tool name + contact info | User-Agent sent with requests |
Since the site does not provide an API, this tool uses HTML scraping. It does not pre-crawl or maintain a database; it only "remembers pages it has seen" via a TTL cache (zero ongoing operation).
It fetches only one item at a time, sends a clearly identified custom User-Agent, and respects request intervals (politeness layer).
Advanced filters (genre/key/step level) are not supported in v1 because the site renders them via JavaScript.
For details, see docs/superpowers/specs/2026-08-07-ptna-enc-mcp-design.md.
作曲家IDからプロフィール概要と作品リストを取得する。
Args: composer_id: ピティナ曲事典の作曲家ID(URLの /persons/ の数字)。
Returns: {composer_id, name, profile, works: [{piece_id, title, url}], url}
Inputs: composer_id (required).
楽曲IDから詳細(正式タイトル・作曲家・作品番号・解説冒頭・URL)を取得する。
search_pieces で見つけた piece_id を渡し、1曲の正式情報を確定する用途。
Args: piece_id: ピティナ曲事典の楽曲ID(URLの /musics/ の数字)。
Returns: {piece_id, title, opus, composer, composer_id, description, url}
Inputs: piece_id (required).
作曲家名で検索し、本家の正式名・作曲家ID・URLの候補を返す。
作曲家名の表記揺れ校正用(例:「ブルグミュラー」→正式表記の確認)。 内部的には楽曲検索結果から作曲家をユニーク抽出する。
Args: name: 作曲家名またはその断片。 limit: 返す件数の上限(既定20)。
Returns: {"count": int, "composers": [{composer_id, name, url}]}
Inputs: name (required), limit.
曲名・作曲家名のキーワードでピティナ曲事典の楽曲を検索する。
表記揺れ校正の中心ツール。手元の曖昧な曲名(例:「ブルクミュラー 25の練習曲」)を 渡すと、本家の正式タイトル・作曲家名・作品番号・演奏時間・曲IDの候補一覧を返す。
Args: keyword: 検索語(曲名/作曲家名/その断片)。 limit: 返す件数の上限(既定20)。
Returns: {"count": int, "results": [{piece_id, title, title_en, composer, composer_id, opus, duration, url}]}
Inputs: keyword (required), limit.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 4 tools
Each tool targets a distinct resource and action: search_pieces and get_piece operate on pieces, while search_composers and get_composer operate on composers. There is no overlap or ambiguity between the search and retrieval functions.
All tool names follow a consistent verb_noun pattern: search_pieces, get_piece, search_composers, get_composer. The verbs 'search' and 'get' are used uniformly to distinguish query operations from detail retrieval.
Four tools is a well-scoped set for a music encyclopedia lookup service. Each tool serves a clear, non-redundant purpose without feeling sparse or bloated.
The tool surface provides complete coverage for browsing the encyclopedia: searching and retrieving both pieces and composers. Search results expose IDs that feed into the get_* tools, and get_composer includes a works list, closing the loop for composer-to-piece exploration.
Find the songwriter behind a name or IPI name number, under every spelling and number.
Repertoire & program archive for classical vocalists. Match works from posters, save, search.
Read-only sheet music discovery and practice tools, with browser-local recognition guidance.
Public music-rights directory: who wrote and owns a song, its ISWC/ISRC/IPI, and licensing asks