@mcptoolshop/ai-jam-sessions 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mcp-tool-shop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.es.md

@@ -0,0 +1,177 @@
+<p align="center">
+  <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <strong>Español</strong> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português</a>
+</p>
+
+<p align="center">
+  <img src="logo.png" alt="AI Jam Session logo" width="180" />
+</p>
+
+<h1 align="center">AI Jam Session</h1>
+
+<p align="center">
+  <em>Aprendizaje Automático a la Antigua</em>
+</p>
+
+<p align="center">
+  Un servidor MCP que enseña a la IA a tocar piano.<br/>
+  120 canciones. 12 géneros. MIDI real. Un diario de práctica que lo recuerda todo.
+</p>
+
+[![Songs](https://img.shields.io/badge/songs-120_across_12_genres-blue)](https://github.com/mcp-tool-shop-org/ai-jam-sessions)
+[![Ready](https://img.shields.io/badge/ready_to_play-24-green)](https://github.com/mcp-tool-shop-org/ai-jam-sessions)
+
+---
+
+## ¿Qué es esto?
+
+Un piano que la IA aprende a tocar. No es un sintetizador, no es una biblioteca MIDI -- es un instrumento de enseñanza.
+
+Un LLM puede leer y escribir texto. Pero no puede experimentar la música como nosotros -- sin oídos, sin ojos, sin memoria muscular. AI Jam Session cierra esa brecha dándole al modelo sentidos que realmente puede usar:
+
+- **Lectura** -- partituras MIDI reales con anotaciones pedagógicas, no aproximaciones escritas a mano
+- **Audición** -- un motor de piano que suena por los altavoces, para que los humanos en la sala sean los oídos de la IA
+- **Visión** -- un piano roll que renderiza lo tocado como SVG que el modelo puede releer y verificar
+- **Memoria** -- un diario de práctica que persiste entre sesiones, para que el aprendizaje se acumule
+
+Cada género tiene un modelo anotado -- una pieza de referencia que la IA estudia antes de abordar el resto. Las otras 96 canciones son MIDI sin procesar, esperando a que la IA aprenda los patrones, toque la música y escriba sus propias anotaciones. Cada sesión continúa donde terminó la anterior.
+
+## El Piano Roll
+
+Así es como la IA ve la música. El piano roll renderiza cualquier canción como SVG -- azul para la mano derecha, coral para la izquierda, con rejillas de pulso, dinámicas y límites de compás:
+
+<p align="center">
+  <img src="docs/fur-elise-m1-8.svg" alt="Piano roll de Für Elise compases 1-8, mostrando mano derecha (azul) y mano izquierda (coral)" width="100%" />
+</p>
+
+<p align="center"><em>Für Elise, compases 1-8 -- el trino E5-D#5 en azul, acompañamiento de bajo en coral</em></p>
+
+La mayoría de los piano rolls son animaciones de reproducción diseñadas para productores humanos. Este está construido para IA. El formato SVG permite al modelo tanto *ver* la imagen como *leer* el código fuente para verificar la precisión de tono, independencia de manos y ritmo. No es una visualización -- es un bucle de retroalimentación.
+
+## El Ciclo de Aprendizaje
+
+```
+ Leer                Tocar              Ver                 Reflexionar
+┌──────────┐     ┌───────────┐     ┌────────────┐     ┌──────────────┐
+│ Estudiar  │     │ Tocar la  │     │ Ver el     │     │ Escribir lo  │
+│ el modelo │ ──▶ │ canción a │ ──▶ │ piano roll │ ──▶ │ aprendido en │
+│ anotado   │     │ cualquier │     │ para       │     │ el diario    │
+│           │     │ velocidad │     │ verificar  │     │              │
+└──────────┘     └───────────┘     └────────────┘     └──────┬───────┘
+                                                             │
+                                                             ▼
+                                                    ┌──────────────┐
+                                                    │ La siguiente  │
+                                                    │ sesión        │
+                                                    │ continúa aquí │
+                                                    └──────────────┘
+```
+
+## La Biblioteca de Canciones
+
+120 canciones en 12 géneros, construidas a partir de archivos MIDI reales. Cada género tiene un modelo completamente anotado -- una pieza de referencia que la IA estudia antes de abordar el resto.
+
+| Género | Canciones | Modelo |
+|--------|-----------|--------|
+| Clásica | 10 listas | Für Elise, Clair de Lune, Moonlight Sonata... |
+| R&B | 4 listas | Superstition (Stevie Wonder) |
+| Jazz | 1 lista | Autumn Leaves |
+| Blues | 1 lista | The Thrill Is Gone (B.B. King) |
+| Pop | 1 lista | Imagine (John Lennon) |
+| Rock | 1 lista | Your Song (Elton John) |
+| Soul | 1 lista | Lean on Me (Bill Withers) |
+| Latina | 1 lista | The Girl from Ipanema |
+| Cine | 1 lista | Comptine d'un autre été (Yann Tiersen) |
+| Ragtime | 1 lista | The Entertainer (Scott Joplin) |
+| New-Age | 1 lista | River Flows in You (Yiruma) |
+| Folk | 1 lista | Greensleeves |
+
+Las canciones progresan de **raw** (solo MIDI) a **ready** (completamente anotadas y reproducibles). La IA promueve canciones estudiándolas y escribiendo anotaciones con `annotate_song`.
+
+## El Diario de Práctica
+
+El diario es la memoria de la IA. Después de tocar una canción, el servidor registra lo que sucedió -- qué canción, a qué velocidad, cuántos compases, cuánto tiempo. La IA agrega sus propias reflexiones: qué patrones notó, qué reconoció, qué intentar después.
+
+```markdown
+---
+### 14:32 — Autumn Leaves
+**jazz** | intermediate | G minor | 69 BPM x 0.7x | 32/32 measures | 45s
+
+El ii-V-I en los compases 5-8 (Cm7-F7-BbMaj7) tiene la misma gravedad
+que el V-i en The Thrill Is Gone, solo que en mayor. El blues y el jazz
+comparten más de lo que sugieren las etiquetas de género.
+
+Próximo: intentar a velocidad completa. Comparar la modulación del
+puente de Ipanema con esto.
+---
+```
+
+Un archivo markdown por día, almacenado en `~/.pianoai/journal/`. Legible por humanos, solo adición. En la siguiente sesión, la IA lee su diario y continúa donde lo dejó.
+
+## Instalación
+
+```bash
+npm install -g @mcptoolshop/ai-jam-sessions
+```
+
+Requiere **Node.js 18+**. Sin controladores MIDI, sin puertos virtuales, sin software externo.
+
+### Claude Desktop / Claude Code
+
+```json
+{
+  "mcpServers": {
+    "ai_jam_sessions": {
+      "command": "npx",
+      "args": ["-y", "-p", "@mcptoolshop/ai-jam-sessions", "ai-jam-sessions-mcp"]
+    }
+  }
+}
+```
+
+## Herramientas MCP
+
+### Aprender
+
+| Herramienta | Función |
+|-------------|---------|
+| `list_songs` | Buscar por género, dificultad o palabra clave |
+| `song_info` | Análisis musical, objetivos pedagógicos, consejos de estilo |
+| `library_progress` | Estado de anotación en todos los géneros |
+| `list_measures` | Notas y apuntes de enseñanza de cada compás |
+| `teaching_note` | Análisis profundo de un compás individual |
+
+### Tocar
+
+| Herramienta | Función |
+|-------------|---------|
+| `play_song` | Reproducir por altavoces (velocidad, modo, rango de compases) |
+| `stop_playback` | Detener la canción actual |
+| `pause_playback` | Pausar o reanudar |
+| `set_speed` | Cambiar velocidad durante la reproducción |
+| `view_piano_roll` | Renderizar canción como piano roll SVG |
+
+### Recordar
+
+| Herramienta | Función |
+|-------------|---------|
+| `save_practice_note` | Escribir una entrada en el diario (datos de sesión capturados automáticamente) |
+| `read_practice_journal` | Cargar entradas recientes para contexto |
+| `annotate_song` | Promover una canción sin procesar a lista (la tarea de la IA) |
+
+## CLI
+
+```
+pianoai list [--genre <genre>] [--difficulty <level>]
+pianoai play <song-id> [--speed <mult>] [--mode <mode>]
+pianoai view <song-id> [--measures <start-end>] [--out <file.svg>]
+pianoai info <song-id>
+pianoai library
+```
+
+## Estado
+
+v0.1.0. 120 archivos MIDI en 12 géneros. 24 canciones completamente anotadas y reproducibles (un modelo por género + 10 clásicas + 4 R&B). Diario de práctica para aprendizaje persistente entre sesiones. Seis voces de teclado (grand, upright, electric, honkytonk, musicbox, bright). Todo el MIDI está listo -- la biblioteca crece a medida que la IA aprende.
+
+## Licencia
+
+MIT

package/README.fr.md

@@ -0,0 +1,178 @@
+<p align="center">
+  <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <strong>Français</strong> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português</a>
+</p>
+
+<p align="center">
+  <img src="logo.png" alt="AI Jam Session logo" width="180" />
+</p>
+
+<h1 align="center">AI Jam Session</h1>
+
+<p align="center">
+  <em>L'apprentissage automatique à l'ancienne</em>
+</p>
+
+<p align="center">
+  Un serveur MCP qui apprend à l'IA à jouer du piano.<br/>
+  120 morceaux. 12 genres. Du vrai MIDI. Un journal de pratique qui se souvient de tout.
+</p>
+
+[![Songs](https://img.shields.io/badge/songs-120_across_12_genres-blue)](https://github.com/mcp-tool-shop-org/ai-jam-sessions)
+[![Ready](https://img.shields.io/badge/ready_to_play-24-green)](https://github.com/mcp-tool-shop-org/ai-jam-sessions)
+
+---
+
+## Qu'est-ce que c'est ?
+
+Un piano que l'IA apprend à jouer. Pas un synthétiseur, pas une bibliothèque MIDI -- un instrument pédagogique.
+
+Un LLM peut lire et écrire du texte. Mais il ne peut pas vivre la musique comme nous -- pas d'oreilles, pas d'yeux, pas de mémoire musculaire. AI Jam Session comble ce fossé en donnant au modèle des sens qu'il peut réellement utiliser :
+
+- **Lecture** -- de vraies partitions MIDI avec annotations pédagogiques, pas des approximations manuscrites
+- **Écoute** -- un moteur de piano qui joue par les haut-parleurs, pour que les humains dans la pièce deviennent les oreilles de l'IA
+- **Vision** -- un piano roll qui rend ce qui a été joué en SVG, que le modèle peut relire et vérifier
+- **Mémoire** -- un journal de pratique qui persiste entre les sessions, pour que l'apprentissage s'accumule
+
+Chaque genre a un modèle annoté -- une pièce de référence que l'IA étudie avant d'aborder le reste. Les 96 autres morceaux sont du MIDI brut, attendant que l'IA apprenne les motifs, joue la musique et rédige ses propres annotations. Chaque session reprend là où la précédente s'est arrêtée.
+
+## Le Piano Roll
+
+Voici comment l'IA voit la musique. Le piano roll rend n'importe quel morceau en SVG -- bleu pour la main droite, corail pour la gauche, avec grilles de temps, nuances et limites de mesures :
+
+<p align="center">
+  <img src="docs/fur-elise-m1-8.svg" alt="Piano roll de Für Elise mesures 1-8, montrant la main droite (bleu) et la main gauche (corail)" width="100%" />
+</p>
+
+<p align="center"><em>Für Elise, mesures 1-8 -- le trille E5-D#5 en bleu, accompagnement de basse en corail</em></p>
+
+La plupart des piano rolls sont des animations de lecture conçues pour les producteurs humains. Celui-ci est conçu pour l'IA. Le format SVG permet au modèle de *voir* l'image et de *lire* le code source pour vérifier la justesse des notes, l'indépendance des mains et le rythme. Ce n'est pas une visualisation -- c'est une boucle de rétroaction.
+
+## La Boucle d'Apprentissage
+
+```
+ Lire                Jouer              Voir                Réfléchir
+┌──────────┐     ┌───────────┐     ┌────────────┐     ┌──────────────┐
+│ Étudier   │     │ Jouer le  │     │ Voir le    │     │ Écrire ce    │
+│ l'analyse │ ──▶ │ morceau à │ ──▶ │ piano roll │ ──▶ │ qu'on a      │
+│ modèle    │     │ n'importe │     │ pour       │     │ appris       │
+│           │     │ quelle    │     │ vérifier   │     │              │
+│           │     │ vitesse   │     │            │     │              │
+└──────────┘     └───────────┘     └────────────┘     └──────┬───────┘
+                                                             │
+                                                             ▼
+                                                    ┌──────────────┐
+                                                    │ La session   │
+                                                    │ suivante     │
+                                                    │ reprend ici  │
+                                                    └──────────────┘
+```
+
+## La Bibliothèque
+
+120 morceaux dans 12 genres, construits à partir de vrais fichiers MIDI. Chaque genre a un modèle entièrement annoté -- une pièce de référence que l'IA étudie avant d'aborder le reste.
+
+| Genre | Morceaux | Modèle |
+|-------|----------|--------|
+| Classique | 10 prêts | Für Elise, Clair de Lune, Sonate au clair de lune... |
+| R&B | 4 prêts | Superstition (Stevie Wonder) |
+| Jazz | 1 prêt | Les Feuilles mortes |
+| Blues | 1 prêt | The Thrill Is Gone (B.B. King) |
+| Pop | 1 prêt | Imagine (John Lennon) |
+| Rock | 1 prêt | Your Song (Elton John) |
+| Soul | 1 prêt | Lean on Me (Bill Withers) |
+| Latin | 1 prêt | La Fille d'Ipanema |
+| Film | 1 prêt | Comptine d'un autre été (Yann Tiersen) |
+| Ragtime | 1 prêt | The Entertainer (Scott Joplin) |
+| New-Age | 1 prêt | River Flows in You (Yiruma) |
+| Folk | 1 prêt | Greensleeves |
+
+Les morceaux progressent de **raw** (MIDI uniquement) à **ready** (entièrement annotés et jouables). L'IA promeut les morceaux en les étudiant et en écrivant des annotations avec `annotate_song`.
+
+## Le Journal de Pratique
+
+Le journal est la mémoire de l'IA. Après avoir joué un morceau, le serveur enregistre ce qui s'est passé -- quel morceau, à quelle vitesse, combien de mesures, combien de temps. L'IA ajoute ses propres réflexions : les motifs remarqués, les schémas reconnus, ce qu'elle veut essayer ensuite.
+
+```markdown
+---
+### 14:32 — Les Feuilles mortes
+**jazz** | intermediate | G minor | 69 BPM x 0.7x | 32/32 measures | 45s
+
+Le ii-V-I aux mesures 5-8 (Cm7-F7-BbMaj7) a la même gravité que le
+V-i dans The Thrill Is Gone, mais en majeur. Le blues et le jazz ont
+plus en commun que les étiquettes de genre ne le suggèrent.
+
+Prochaine fois : essayer à pleine vitesse. Comparer la modulation du
+pont d'Ipanema avec ceci.
+---
+```
+
+Un fichier markdown par jour, stocké dans `~/.pianoai/journal/`. Lisible par un humain, en ajout uniquement. À la session suivante, l'IA lit son journal et reprend là où elle s'était arrêtée.
+
+## Installation
+
+```bash
+npm install -g @mcptoolshop/ai-jam-sessions
+```
+
+Nécessite **Node.js 18+**. Pas de pilotes MIDI, pas de ports virtuels, pas de logiciel externe.
+
+### Claude Desktop / Claude Code
+
+```json
+{
+  "mcpServers": {
+    "ai_jam_sessions": {
+      "command": "npx",
+      "args": ["-y", "-p", "@mcptoolshop/ai-jam-sessions", "ai-jam-sessions-mcp"]
+    }
+  }
+}
+```
+
+## Outils MCP
+
+### Apprendre
+
+| Outil | Fonction |
+|-------|----------|
+| `list_songs` | Parcourir par genre, difficulté ou mot-clé |
+| `song_info` | Analyse musicale, objectifs pédagogiques, conseils de style |
+| `library_progress` | État d'annotation de tous les genres |
+| `list_measures` | Notes et annotations de chaque mesure |
+| `teaching_note` | Analyse approfondie d'une mesure |
+
+### Jouer
+
+| Outil | Fonction |
+|-------|----------|
+| `play_song` | Jouer par les haut-parleurs (vitesse, mode, plage de mesures) |
+| `stop_playback` | Arrêter le morceau en cours |
+| `pause_playback` | Mettre en pause ou reprendre |
+| `set_speed` | Changer la vitesse en cours de lecture |
+| `view_piano_roll` | Afficher le morceau en piano roll SVG |
+
+### Se souvenir
+
+| Outil | Fonction |
+|-------|----------|
+| `save_practice_note` | Écrire une entrée de journal (données de session capturées automatiquement) |
+| `read_practice_journal` | Charger les entrées récentes pour le contexte |
+| `annotate_song` | Promouvoir un morceau brut en prêt (les devoirs de l'IA) |
+
+## CLI
+
+```
+pianoai list [--genre <genre>] [--difficulty <level>]
+pianoai play <song-id> [--speed <mult>] [--mode <mode>]
+pianoai view <song-id> [--measures <start-end>] [--out <file.svg>]
+pianoai info <song-id>
+pianoai library
+```
+
+## Statut
+
+v0.1.0. 120 fichiers MIDI dans 12 genres. 24 morceaux entièrement annotés et jouables (un modèle par genre + 10 classiques + 4 R&B). Journal de pratique pour un apprentissage persistant entre les sessions. Six voix de clavier (grand, upright, electric, honkytonk, musicbox, bright). Tout le MIDI est là -- la bibliothèque grandit au fur et à mesure que l'IA apprend.
+
+## Licence
+
+MIT

package/README.hi.md

@@ -0,0 +1,175 @@
+<p align="center">
+  <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <strong>हिन्दी</strong> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português</a>
+</p>
+
+<p align="center">
+  <img src="logo.png" alt="AI Jam Session लोगो" width="180" />
+</p>
+
+<h1 align="center">AI Jam Session</h1>
+
+<p align="center">
+  <em>पुराने तरीके से मशीन लर्निंग</em>
+</p>
+
+<p align="center">
+  AI को पियानो बजाना सिखाने वाला MCP सर्वर।<br/>
+  120 गाने। 12 शैलियाँ। असली MIDI। एक अभ्यास डायरी जो सब कुछ याद रखती है।
+</p>
+
+[![Songs](https://img.shields.io/badge/songs-120_across_12_genres-blue)](https://github.com/mcp-tool-shop-org/ai-jam-sessions)
+[![Ready](https://img.shields.io/badge/ready_to_play-24-green)](https://github.com/mcp-tool-shop-org/ai-jam-sessions)
+
+---
+
+## यह क्या है?
+
+एक पियानो जिसे AI बजाना सीखता है। सिंथेसाइज़र नहीं, MIDI लाइब्रेरी नहीं -- एक शिक्षण वाद्य यंत्र।
+
+LLM टेक्स्ट पढ़ और लिख सकता है। लेकिन यह हमारी तरह संगीत का अनुभव नहीं कर सकता -- न कान, न आँखें, न मांसपेशी स्मृति। AI Jam Session मॉडल को ऐसी इंद्रियाँ देकर इस अंतर को पाटता है जिनका वह वास्तव में उपयोग कर सके:
+
+- **पढ़ना** -- शिक्षण एनोटेशन के साथ असली MIDI स्वरलिपि, हाथ से लिखे अनुमान नहीं
+- **सुनना** -- स्पीकर से बजने वाला पियानो इंजन, ताकि कमरे में मौजूद लोग AI के कान बनें
+- **देखना** -- पियानो रोल जो बजाई गई चीज़ को SVG के रूप में रेंडर करता है, जिसे मॉडल वापस पढ़कर सत्यापित कर सकता है
+- **याद रखना** -- सत्रों के बीच बनी रहने वाली अभ्यास डायरी, ताकि सीखना संचित हो
+
+हर शैली में एक एनोटेटेड आदर्श है -- AI बाकी पर काम करने से पहले जिसका अध्ययन करता है। बाकी 96 गाने कच्चे MIDI हैं, AI की प्रतीक्षा में कि वह पैटर्न सीखे, संगीत बजाए, और खुद एनोटेशन लिखे। हर सत्र पिछले से आगे बढ़ता है।
+
+## पियानो रोल
+
+AI संगीत को इस तरह देखता है। पियानो रोल किसी भी गाने को SVG के रूप में रेंडर करता है -- दाहिने हाथ के लिए नीला, बाएं के लिए मूंगा, बीट ग्रिड, गतिशीलता और बार सीमाओं के साथ:
+
+<p align="center">
+  <img src="docs/fur-elise-m1-8.svg" alt="Für Elise बार 1-8 का पियानो रोल, दाहिना हाथ (नीला) और बायाँ हाथ (मूंगा) दिखाते हुए" width="100%" />
+</p>
+
+<p align="center"><em>Für Elise, बार 1-8 -- नीले रंग में E5-D#5 ट्रिल, मूंगा रंग में बास संगत</em></p>
+
+अधिकांश पियानो रोल मानव निर्माताओं के लिए प्लेबैक एनिमेशन हैं। यह AI के लिए बना है। SVG प्रारूप का मतलब है कि मॉडल इसे एक छवि के रूप में *देख* भी सकता है और स्रोत मार्कअप *पढ़कर* स्वर सटीकता, हाथ स्वतंत्रता और लय सत्यापित कर सकता है। यह विज़ुअलाइज़ेशन नहीं है -- यह एक फ़ीडबैक लूप है।
+
+## सीखने का चक्र
+
+```
+ पढ़ना               बजाना              देखना               चिंतन
+┌──────────┐     ┌───────────┐     ┌────────────┐     ┌──────────────┐
+│ आदर्श का  │     │ किसी भी   │     │ पियानो रोल │     │ जो सीखा वह  │
+│ विश्लेषण  │ ──▶ │ गति पर    │ ──▶ │ से सत्यापित│ ──▶ │ डायरी में   │
+│ अध्ययन    │     │ गाना बजाएं│     │ करें       │     │ लिखें       │
+└──────────┘     └───────────┘     └────────────┘     └──────┬───────┘
+                                                             │
+                                                             ▼
+                                                    ┌──────────────┐
+                                                    │ अगला सत्र    │
+                                                    │ यहाँ से शुरू │
+                                                    └──────────────┘
+```
+
+## गाना पुस्तकालय
+
+12 शैलियों में 120 गाने, असली MIDI फ़ाइलों से निर्मित। हर शैली में एक पूर्ण एनोटेटेड आदर्श है -- एक संदर्भ टुकड़ा जिसे AI बाकी पर काम करने से पहले अध्ययन करता है।
+
+| शैली | गाने | आदर्श |
+|------|------|-------|
+| शास्त्रीय | 10 तैयार | Für Elise, Clair de Lune, Moonlight Sonata... |
+| R&B | 4 तैयार | Superstition (स्टीवी वंडर) |
+| जैज़ | 1 तैयार | Autumn Leaves |
+| ब्लूज़ | 1 तैयार | The Thrill Is Gone (B.B. King) |
+| पॉप | 1 तैयार | Imagine (जॉन लेनन) |
+| रॉक | 1 तैयार | Your Song (एल्टन जॉन) |
+| सोल | 1 तैयार | Lean on Me (बिल विदर्स) |
+| लैटिन | 1 तैयार | The Girl from Ipanema |
+| फ़िल्म | 1 तैयार | Comptine d'un autre été (यान टियर्सन) |
+| रैगटाइम | 1 तैयार | The Entertainer (स्कॉट जोप्लिन) |
+| न्यू-एज | 1 तैयार | River Flows in You (यिरुमा) |
+| लोक | 1 तैयार | Greensleeves |
+
+गाने **raw** (केवल MIDI) से **ready** (पूर्ण एनोटेटेड और बजाने योग्य) तक प्रगति करते हैं। AI `annotate_song` से एनोटेशन लिखकर गानों को प्रमोट करता है।
+
+## अभ्यास डायरी
+
+डायरी AI की स्मृति है। गाना बजाने के बाद, सर्वर रिकॉर्ड करता है क्या हुआ -- कौन सा गाना, किस गति पर, कितने बार, कितने समय तक। AI अपने स्वयं के चिंतन जोड़ता है: कौन से पैटर्न देखे, क्या पहचाना, आगे क्या प्रयास करना है।
+
+```markdown
+---
+### 14:32 — Autumn Leaves
+**jazz** | intermediate | G minor | 69 BPM x 0.7x | 32/32 measures | 45s
+
+बार 5-8 में ii-V-I (Cm7-F7-BbMaj7) वही गुरुत्वाकर्षण है जो
+The Thrill Is Gone में V-i का है, बस मेजर में। ब्लूज़ और जैज़ में
+शैली लेबल जितना दिखाते हैं उससे कहीं ज़्यादा समानता है।
+
+अगली बार: पूरी गति पर प्रयास करें। इपानेमा के ब्रिज मॉड्यूलेशन
+की तुलना इससे करें।
+---
+```
+
+प्रतिदिन एक markdown फ़ाइल, `~/.pianoai/journal/` में संग्रहीत। मानव-पठनीय, केवल जोड़ना। अगले सत्र में AI अपनी डायरी पढ़ता है और जहाँ छोड़ा था वहाँ से शुरू करता है।
+
+## इंस्टॉल
+
+```bash
+npm install -g @mcptoolshop/ai-jam-sessions
+```
+
+**Node.js 18+** आवश्यक। कोई MIDI ड्राइवर नहीं, कोई वर्चुअल पोर्ट नहीं, कोई बाहरी सॉफ़्टवेयर नहीं।
+
+### Claude Desktop / Claude Code
+
+```json
+{
+  "mcpServers": {
+    "ai_jam_sessions": {
+      "command": "npx",
+      "args": ["-y", "-p", "@mcptoolshop/ai-jam-sessions", "ai-jam-sessions-mcp"]
+    }
+  }
+}
+```
+
+## MCP उपकरण
+
+### सीखें
+
+| उपकरण | कार्य |
+|--------|-------|
+| `list_songs` | शैली, कठिनाई, या कीवर्ड से ब्राउज़ करें |
+| `song_info` | संगीत विश्लेषण, शिक्षण लक्ष्य, शैली सुझाव |
+| `library_progress` | सभी शैलियों में एनोटेशन स्थिति |
+| `list_measures` | हर बार के नोट्स और शिक्षण नोट्स |
+| `teaching_note` | एक बार का गहन विश्लेषण |
+
+### बजाएं
+
+| उपकरण | कार्य |
+|--------|-------|
+| `play_song` | स्पीकर से बजाएं (गति, मोड, बार रेंज) |
+| `stop_playback` | वर्तमान गाना रोकें |
+| `pause_playback` | रोकें या फिर से शुरू करें |
+| `set_speed` | प्लेबैक के दौरान गति बदलें |
+| `view_piano_roll` | गाने को SVG पियानो रोल के रूप में रेंडर करें |
+
+### याद रखें
+
+| उपकरण | कार्य |
+|--------|-------|
+| `save_practice_note` | डायरी प्रविष्टि लिखें (सत्र डेटा स्वचालित रूप से कैप्चर) |
+| `read_practice_journal` | संदर्भ के लिए हाल की प्रविष्टियाँ लोड करें |
+| `annotate_song` | कच्चे गाने को तैयार में प्रमोट करें (AI का होमवर्क) |
+
+## CLI
+
+```
+pianoai list [--genre <genre>] [--difficulty <level>]
+pianoai play <song-id> [--speed <mult>] [--mode <mode>]
+pianoai view <song-id> [--measures <start-end>] [--out <file.svg>]
+pianoai info <song-id>
+pianoai library
+```
+
+## स्थिति
+
+v0.1.0। 12 शैलियों में 120 MIDI फ़ाइलें। 24 गाने पूर्ण एनोटेटेड और बजाने योग्य (प्रति शैली एक आदर्श + 10 शास्त्रीय + 4 R&B)। सत्रों के बीच निरंतर सीखने के लिए अभ्यास डायरी। छह कीबोर्ड ध्वनियाँ (grand, upright, electric, honkytonk, musicbox, bright)। सभी MIDI तैयार हैं -- AI सीखता है तो पुस्तकालय बढ़ता है।
+
+## लाइसेंस
+
+MIT