피티나 피아노곡 사전 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.