Skip to main content
Glama
deenesjakoruzh
Rikublender3d

ptna-enc-mcp

by Rikublender3d
OverviewSchemaRelated ServersScoreDiscussions
Python

ピティナ・ピアノ曲事典 MCP 服务器

以ピティナ・ピアノ曲事典为「正典（主数据）」，用于校正音乐会节目中曲名・作曲家名表记不一致的 MCP 服务器。

输入模糊的曲名，即可返回本家的正式标题・作曲家名・作品编号・演奏时长。

ℹ️ 这是ピティナ非官方的个人工具。曲事典的解说文等著作权归ピティナ／原作者所有。 个人使用・校正是可以的，但请不要转载输出内容或进行大量访问。

功能（工具）

工具

用途

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。以此作为正典采用。

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 即表示成功。

运行确认

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

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