Skip to main content
Glama
deenesjakoruzh
Rikublender3d

ptna-enc-mcp

by Rikublender3d
OverviewSchemaRelated ServersScoreDiscussions
Python

Ptina Piano Music Encyclopedia MCP Server

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.

Available Tools

Tool

Purpose

search_pieces(keyword, limit=20)

Search for pieces by piece/composer keyword. Returns a list of candidates with official title, composer, opus, duration, and piece ID (core proofreading tool)

get_piece(piece_id)

Retrieve details by piece ID (official title, original title, opus, opening description)

search_composers(name, limit=20)

Search for composer names in official notation and IDs

get_composer(composer_id)

Retrieve composer profile and list of works

Usage Example

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

Setup

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

Registering with Claude Code

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

After 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.

Operation Check

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

Configuration (Environment Variables, Optional)

Variable

Default

Meaning

PTNA_ENC_MIN_INTERVAL

1.5

Minimum request interval (seconds)

PTNA_ENC_CACHE_TTL

86400

Page cache validity period (seconds). 0 disables caching

PTNA_ENC_CACHE_DIR

~/.cache/ptna-enc-mcp

Cache storage location

PTNA_ENC_USER_AGENT

Tool name + contact info

User-Agent sent with requests

Design and Scraping Policy

  • 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.

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • Genji MCP Server

    nakamura196
    A
    license
    A
    quality
    D
    maintenance
    Provides access to the Genji API for searching and analyzing classical Japanese literature texts with advanced normalization features for historical Japanese text variations, including repeat marks expansion, kanji-kana unification, and historical kana handling.
    4
    13
    MIT

  • MusicBrainz MCP Server

    zas
    A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to query the MusicBrainz music database for artists, albums, recordings, and labels. It provides tools for advanced searches, detailed metadata retrieval, and accessing cover art information.
    17
    10
    GPL 3.0

  • notation-mcp

    delmas41
    A
    license
    A
    quality
    C
    maintenance
    Render music notation from a JSON score to inline SVG (Verovio + Bravura), round-trippable MusicXML, and base64 MIDI in one call. Includes pre-flight validation with concrete fix suggestions and a curated music-theory knowledge search. Free, open, no auth, sponsored by Gradus School of Music Composition.
    5
    175
    2
    MIT

  • music21-mcp

    FernandoDaSilva-T
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables musical analysis of MIDI and musicXML files using music21, providing tools for key detection, harmony, melody, rhythm, form analysis, counterpoint checking, and motif extraction.
    MIT

View all related MCP servers

Related MCP Connectors

  • musicbrainz-mcp-server

    Search MusicBrainz artists, releases, works, labels; resolve ISRC/ISWC/barcode; fetch cover art.

  • Japan Food DB

    Resolve Japanese food names to nutrition facts. All 2,538 foods from Japan's official tables.

  • wikidata-mcp-server

    Search and fetch Wikidata entities, execute SPARQL queries, and resolve external identifiers.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Rikublender3d/ptna-enc-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server