mcp-imslp

An MCP server for IMSLP, the Petrucci Music Library: works, scores and recordings of classical music, catalogued by the volunteers who run it. No API key and no account are needed.

The library publishes its pages under CC BY-SA 4.0, so anything shown from this server credits IMSLP and links the page it came from.

What it reads, and what it leaves alone

Reads go through the MediaWiki API at /api.php and through the listing endpoint IMSLP documents on its own IMSLP:API page. The robots.txt of the site disallows /index.php, /images/, /imglnks/, /wiki/File:, /works and /library/, and this server builds no address under any of them: it downloads no score file, and hands back the link to the work page instead.

IMSLP publishes Crawl-delay: 2, so requests run one at a time with at least two seconds between them. That floor holds however the server is configured.

Copyright status

A score on IMSLP carries a status per jurisdiction, and the library reviews Canada, the United States and the European Union. A file can read Public Domain - Non-PD US: free in one place and protected in another. This server reports the status as published, per jurisdiction, and never flattens it into "public domain".

Configuration

| Variable | Default | What it does | | ------------------------- | -------------------- | ------------------------------------------------------------------------------------ | | IMSLP_USER_AGENT | the project identity | Names your application; the project identity is appended so IMSLP can reach a person | | IMSLP_MIN_INTERVAL_MS | 2500 | Gap between requests, never below 2000 | | IMSLP_TIMEOUT_MS | 30000 | Deadline for one request | | IMSLP_MAX_RETRIES | 3 | Attempts after a transient failure | | IMSLP_CACHE_TTL_MS | 900000 | How long a page stays in memory | | IMSLP_CACHE_MAX_ENTRIES | 100 | Pages held at once | | IMSLP_LOG_LEVEL | error | silent, error, info or debug, on stderr |

Licence

MIT, see LICENSE. The data belongs to IMSLP and its contributors.

mcp-imslp (français)

Un serveur MCP pour IMSLP, la Petrucci Music Library : œuvres, partitions et enregistrements de musique classique, catalogués par les bénévoles qui la tiennent. Aucune clé d'API, aucun compte.

La bibliothèque publie ses pages sous CC BY-SA 4.0, donc tout ce que ce serveur rend attribue à IMSLP et renvoie vers la page d'origine.

Ce qu'il lit, et ce qu'il laisse

Les lectures passent par l'API MediaWiki /api.php et par le point d'entrée qu'IMSLP documente sur sa page IMSLP:API. Le robots.txt du site interdit /index.php, /images/, /imglnks/, /wiki/File:, /works et /library/, et ce serveur ne construit aucune adresse sous ces chemins : il ne télécharge aucun fichier de partition et rend le lien de la page de l'œuvre.

IMSLP publie Crawl-delay: 2, donc les requêtes partent une à une, avec au moins deux secondes entre elles, quelle que soit la configuration.

Le statut de droits

Une partition porte sur IMSLP un statut par juridiction, et la bibliothèque vérifie le Canada, les États-Unis et l'Union européenne. Un fichier peut être Public Domain - Non-PD US : libre ici et protégé ailleurs. Ce serveur rend le statut tel qu'il est publié, juridiction par juridiction.