PlayByKey Music Theory
Chords, scales, progressions, transposition, and MIDI tools for music theory AI agents.
Que pouvez-vous faire avec PlayByKey Music Theory ?
- npm: npmjs.com/package/@playbykey/theory
- Documentation: theory-engine.docs.playbykey.com - interactive playgrounds
- Changelog: GitHub Releases
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
@playbykey/theory-mcpclaude mcp add playbykey-music-theory -- npx -y @playbykey/theory-mcp@1.6.0
{
"mcpServers": {
"playbykey-music-theory": {
"command": "npx",
"args": [
"-y",
"@playbykey/theory-mcp@1.6.0"
]
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Developer Tools
Packages for PlayByKey - see the table below for what's here.
- npm: npmjs.com/package/@playbykey/theory
- Documentation: theory-engine.docs.playbykey.com - interactive playgrounds
- Changelog: GitHub Releases
Install
npm install @playbykey/theory
pnpm add @playbykey/theory
yarn add @playbykey/theory
bun add @playbykey/theory
Quickstart and API examples: packages/theory/README.md
Why @playbykey/theory
- Foundation music theory engine: music theory as code. Modes, keys, intervals, and scale relationships resolved deterministically; one source of truth every app, notation tool, or AI agent can build on.
- Zero dependencies: no transitive baggage; safe for agents, edge runtimes, and tight bundles
- Strictly typed: every function's types exported alongside it, no
any - Agent-ready: copy-paste LLM context prompt and interactive docs
- Sharps-only notation: one canonical spelling per note (
C#, notDb) keeps theNotetype safe and unambiguous. Flats are fully supported for both input (parseNote/parseNoteTokenacceptDb,Eb,Gb,Ab,Bb) and output (getFlats/getEnharmonicLabels), without extendingNoteitself.
Packages
| Package | Description | Links |
|---|---|---|
@playbykey/theory | Zero-dependency music theory engine - scales, modes, intervals, chords, progressions, key relationships | npm · docs · changelog |
@playbykey/theory-mcp | MCP server that exposes the theory engine as AI-callable tools | npm · README |
theory-docs | Starlight documentation site (private workspace package) | live site · README |
License
MIT for the repository tooling and @playbykey/theory. See LICENSE.
Individual packages may declare their own license in their package.json.
Questions fréquentes
Qu'est-ce que PlayByKey Music Theory ?
Chords, scales, progressions, transposition, and MIDI tools for music theory AI agents.
Comment installer PlayByKey Music Theory ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add playbykey-music-theory -- npx -y @playbykey/theory-mcp@1.6.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour PlayByKey Music Theory ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
PlayByKey Music Theory est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient PlayByKey Music Theory ?
Il est publié par DigitalBrewLLC. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.