hornlib-cli 1.0.3 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +99 -33
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,62 +1,118 @@
1
1
  # hornlib-cli — French Horn Fingering Chart, Transposition & Harmonics CLI (`hornlib.com`)
2
2
 
3
- [![Official Website](https://img.shields.io/badge/Official_Studio-hornlib.com-blue)](https://hornlib.com)
4
- [![MCPTry 100/100](https://mcptry.com/badge/com.hornlib/mcp)](https://www.mcptry.com/servers/com.hornlib/mcp)
3
+ [![Official Studio](https://img.shields.io/badge/Official_Studio-hornlib.com-blue)](https://hornlib.com)
4
+ [![MCPTry Verified](https://mcptry.com/badge/com.hornlib/mcp)](https://www.mcptry.com/servers/com.hornlib/mcp)
5
5
  [![Glama Grade A](https://glama.ai/mcp/connectors/com.hornlib/mcp/badges/score.svg)](https://glama.ai/mcp/connectors/com.hornlib/mcp)
6
6
  [![ClawHub Skill](https://img.shields.io/badge/ClawHub-@hornlib%2Fhornlib-orange)](https://clawhub.ai/hornlib/skills/hornlib)
7
7
  [![License: MIT](https://img.shields.io/badge/License-MIT-emerald)](./LICENSE)
8
8
 
9
- Official command-line interface and zero-dependency client for [**HornLib (https://hornlib.com)**](https://hornlib.com) — the interactive French Horn F/Bb double horn fingering studio, multi-key pitch transposer, natural overtone harmonic series analyzer, and orchestral audition excerpt library.
9
+ Official zero-dependency command-line interface and **Model Context Protocol (MCP)** client for **[HornLib (https://hornlib.com)](https://hornlib.com)** — the interactive French Horn F/Bb double horn fingering studio, historical crook pitch transposer, natural overtone harmonic series analyzer, and orchestral audition excerpt library. All 8 remote tools run statelessly over `streamable-http` at `https://hornlib.com/api/mcp` with zero API keys or login required.
10
10
 
11
11
  ---
12
12
 
13
- ## ⚡ Quick Start (`npx`)
13
+ ## Quick Start (`npx`)
14
14
 
15
- Run directly without installation:
15
+ Run pinned CLI commands directly from any Node.js >= 18 terminal:
16
16
 
17
17
  ```bash
18
- # Look up F-side, Bb-trigger, and alternate valve fingerings for any note (C1 to F6)
19
- npx hornlib-cli fingering G4 double
18
+ # Look up F-side, Bb-trigger, and alternate valve fingerings for any written horn pitch (C1 to F6)
19
+ npx -y hornlib-cli@1.0.4 fingering G4 double
20
20
 
21
- # Transpose written horn pitch across historical crooks (F, Bb, Eb, D, C, G, A)
22
- npx hornlib-cli transpose C5 Eb
21
+ # Transpose written French Horn notation across historical orchestral crooks (F, Bb, Eb, D, C, G, A)
22
+ npx -y hornlib-cli@1.0.4 transpose C5 Eb
23
23
 
24
24
  # Inspect natural overtone harmonic series partials & equal-temperament cent deviations
25
- npx hornlib-cli harmonics open F
25
+ npx -y hornlib-cli@1.0.4 harmonics open F
26
26
 
27
- # Retrieve orchestral horn audition excerpt performance guides
28
- npx hornlib-cli excerpt "Strauss Till Eulenspiegel"
27
+ # Retrieve orchestral audition excerpt guides (Mozart, Strauss, Mahler, Brahms, Beethoven)
28
+ npx -y hornlib-cli@1.0.4 excerpt "Strauss Till Eulenspiegel"
29
29
 
30
- # Generate a structured daily brass warmup routine
31
- npx hornlib-cli warmup 30 intermediate
30
+ # Generate a structured daily French Horn practice & warmup plan
31
+ npx -y hornlib-cli@1.0.4 warmup 30 intermediate
32
32
  ```
33
33
 
34
34
  Or install globally:
35
35
 
36
36
  ```bash
37
- npm install -g hornlib-cli
37
+ npm install -g hornlib-cli@1.0.4
38
38
  hornlib fingering C5
39
39
  ```
40
40
 
41
41
  ---
42
42
 
43
- ## 🌐 Interactive Web Tools on [hornlib.com](https://hornlib.com)
43
+ ## Available MCP Tools (8 Read-Only Tools)
44
44
 
45
- | Web Module | Direct URL | Key Capabilities |
46
- | :--- | :--- | :--- |
47
- | **Interactive French Horn Studio** | [https://hornlib.com](https://hornlib.com) | Real-time F/Bb double horn valve visualization, audio playback & pitch reference |
48
- | **F/Bb Double Horn Fingering Chart** | [https://hornlib.com/fingerings](https://hornlib.com/fingerings) | Complete 4-octave valve combinations (`C1`–`F6`), trigger (`T`) toggles & trills |
49
- | **7-in-1 Brass Practice & Transposition Suite** | [https://hornlib.com/7-in-1-tools](https://hornlib.com/7-in-1-tools) | Multi-key crook transposer, drone tuner, metronome & harmonic analyzer |
50
- | **Full Note Compass & Overtone Series** | [https://hornlib.com/all-notes](https://hornlib.com/all-notes) | 1st–16th partial frequencies (Hz), cent deviations (`-31c` 7th, `-49c` 11th) |
51
- | **Orchestral Audition Excerpts** | [https://hornlib.com/excerpts](https://hornlib.com/excerpts) | Curated audition guides for Mozart 4, Strauss, Mahler, Brahms & Tchaikovsky |
52
- | **Beginner Horn & Mouthpiece Guide** | [https://hornlib.com/beginners](https://hornlib.com/beginners) | Kruspe vs Geyer wrap comparison & mouthpiece rim/cup pairing |
53
- | **Acoustics & Pedagogy Articles** | [https://hornlib.com/guides-pedagogy](https://hornlib.com/guides-pedagogy) | Stopped horn (`+`) acoustics, right-hand bell position & embouchure mechanics |
45
+ | Tool Name | Purpose & Acoustic Engine | Key Parameters | Safety |
46
+ | :--- | :--- | :--- | :---: |
47
+ | `lookup_french_horn_fingering` | Look up standard F-side and Bb-trigger valve fingerings, concert pitch transposition (down a perfect fifth), and harmonic tendency notes for any | `note`* | `readOnly` |
48
+ | `transpose_french_horn_pitch` | Transpose written French Horn parts from historical orchestral crooks (Horn in Eb, D, C, G, A, E, Bb-alto, Bb-basso) to modern Horn in F written | `writtenNote`*, `sourceCrook`* | `readOnly` |
49
+ | `analyze_horn_harmonic_series` | Analyze the natural harmonic overtone series (partials 2 through 16) for any F-horn or Bb-horn valve combination, returning equal-temperament cen | `hornSide`*, `valves` | `readOnly` |
50
+ | `lookup_horn_trill_fingering` | Find optimal whole-tone and half-step trill fingerings on the F/Bb double horn, identifying whether a trill should be executed as a mechanical va | `baseNote`*, `interval` | `readOnly` |
51
+ | `get_orchestral_horn_excerpt_guide` | Retrieve audition preparation notes, recommended F/Bb trigger fingerings, breathing plans, and historical crook transpositions for standard orche | `composerOrWork`* | `readOnly` |
52
+ | `diagnose_horn_intonation_and_hand_position` | Diagnose pitch tendencies, right-hand bell acoustics, and Stopped Horn (gestopft / +) transposition rules (transpose down a half-step on the F ho | `topic`* | `readOnly` |
53
+ | `recommend_beginner_horn_and_mouthpiece` | Compare Kruspe wrap (Conn 8D style, dark orchestral projection, larger bell throat) vs Geyer/Knopf wrap (Yamaha 667/671, Alexander 103 style, smo | `playerLevel`* | `readOnly` |
54
+ | `generate_daily_horn_warmup_routine` | Generate a structured daily French Horn warm-up schedule covering harmonic lip slurs, Farkas long tones, double/triple tonguing, low-register ped | `durationMinutes`*, `focusArea` | `readOnly` |
54
55
 
55
56
  ---
56
57
 
57
- ## 🤖 AI Agent & MCP Server Integration (`com.hornlib/mcp`)
58
+ ## Live Production Verification Sample
58
59
 
59
- Connect Claude Desktop, Claude Code, Cursor, Windsurf, Hermes Agent, or OpenClaw directly to HornLib's stateless Streamable HTTP MCP endpoint:
60
+ ```bash
61
+ curl -s -X POST https://hornlib.com/api/mcp \
62
+ -H "Content-Type: application/json" \
63
+ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"lookup_french_horn_fingering","arguments":{"note":"G4","hornType":"double"}}}'
64
+ ```
65
+
66
+ Verified Response excerpt:
67
+
68
+ ```json
69
+ {
70
+ "writtenNote": "G4",
71
+ "concertPitch": "C4",
72
+ "fSideFingering": "0 (Open)",
73
+ "bbSideFingering": "T-1-3",
74
+ "recommendedDoubleHorn": "0 (F side)",
75
+ "intonationTendency": "6th partial on F side — centered",
76
+ "url": "https://hornlib.com/fingerings"
77
+ }
78
+ ```
79
+
80
+ ---
81
+
82
+ ## Acoustic & Orchestral Transposition Reference Tables
83
+
84
+ ### F / Bb Double Horn Valve & Trigger Intonation Mechanics
85
+
86
+ | Horn Side / Register | Fundamental Length | Thumb Trigger State | Acoustic Intonation & Resistance Characteristics |
87
+ | :--- | :---: | :---: | :--- |
88
+ | **F Side (Main Branch)** | ~3.76 m (12 ft 4 in) | Open (`0`) | Richer, darker core tone across middle register (`C4–G4`); shorter harmonic spacing |
89
+ | **Bb Side (Trigger Branch)** | ~2.74 m (9 ft 0 in) | Depressed (`T`) | Wider partial spacing above `G#4–C6`, sharper response and higher security on high attacks |
90
+ | **Stopped Horn (`+`)** | Hand seals bell tightly | Pitch bends +0.5 step | Compensating F horn fingers sound 1 semitone sharper (+1/2 step transpose down to compensate) |
91
+
92
+ ### Natural Overtone Harmonic Series Deviations vs Equal Temperament
93
+
94
+ | Partial Number | Interval Above Fundamental | Just Intonation Cent Deviation | Practical Double Horn Correction Tip |
95
+ | :---: | :--- | :---: | :--- |
96
+ | **1st – 4th Partial** | Octave, Perfect 5th, Double Octave | `0c` to `+2c` | Naturally stable anchor partials for low-register warmth and pedal-tone centering |
97
+ | **5th & 10th Partial** | Major 3rd & Double Octave + 3rd | `-14c` (Flat) | Tend toward flatness on open horn; consider `T-2-3` or `1-2` alternates for E5/G#4 |
98
+ | **7th Partial** | Harmonic Minor 7th | **`-31c` (Very Flat)** | Avoid as open tonic; substitute Bb trigger or `1`/`1-2` valve combinations to center pitch |
99
+ | **11th Partial** | Acoustic Augmented 4th / Neutral 4th | **`-49c` (Quarter-Tone Flat)** | Natural F#5/F5 bend in alpine/hunting horn calls; use Bb `T-2` or F `2` in orchestral tuning |
100
+ | **13th Partial** | Neutral Minor 6th | **`+41c` (Very Sharp)** | Unusable open in ensemble chords; always finger explicitly on the Bb trigger side |
101
+
102
+ ### Orchestral Crook Transposition Offsets (Compared to Horn in F)
103
+
104
+ | Written Orchestral Part | Pitch vs Horn in F | Semitone Shift from Modern F Horn | Representative Repertoire Works |
105
+ | :--- | :--- | :---: | :--- |
106
+ | **Horn in F (Standard)** | Unison | `0` semitones | Modern standard notation, R. Strauss, Mahler, Brahms (except Eb/E) |
107
+ | **Horn in Bb Alto** | Perfect 4th Higher | `+5` semitones | Haydn *Symphony No. 31*, Brahms *Piano Concerto No. 2* |
108
+ | **Horn in Eb** | Major 2nd Lower | `-2` semitones | Mozart *Horn Concerto No. 2/3/4*, Beethoven *Eroica* Trio |
109
+ | **Horn in D** | Minor 3rd Lower | `-3` semitones | Mozart *Symphony No. 35*, Classical symphonies & masses |
110
+ | **Horn in C (Basso)** | Perfect 4th Lower | `-5` semitones | Haydn early symphonies, Beethoven *Symphony No. 1*, Mahler *Symphony No. 1* |
111
+ | **Horn in E / G / A** | Varies (`-1 / +2 / +4`) | `-1`, `+2`, `+4` semitones | Brahms *Horn Trio in Eb*, Tchaikovsky *Romeo & Juliet*, Mendelssohn *Nocturne* |
112
+
113
+ ---
114
+
115
+ ## Connect in Claude Desktop, Cursor, Windsurf & Hermes Agent
60
116
 
61
117
  ```json
62
118
  {
@@ -69,13 +125,23 @@ Connect Claude Desktop, Claude Code, Cursor, Windsurf, Hermes Agent, or OpenClaw
69
125
  }
70
126
  ```
71
127
 
72
- - **MCP Server Repository**: [https://github.com/HornLib/mcp-server](https://github.com/HornLib/mcp-server)
73
- - **ClawHub Skill**: [https://clawhub.ai/hornlib/skills/hornlib](https://clawhub.ai/hornlib/skills/hornlib)
74
- - **Vercel Skills**: [https://www.skills.sh/hornlib/mcp-server/hornlib](https://www.skills.sh/hornlib/mcp-server/hornlib)
75
- - **OpenAPI 3.1 Specification**: [https://hornlib.com/openapi.json](https://hornlib.com/openapi.json)
128
+ ---
129
+
130
+ ## Interactive Web Tools on [hornlib.com](https://hornlib.com)
131
+
132
+ - **[Interactive French Horn F/Bb Valve Studio & Practice Tuner](https://hornlib.com)** — `https://hornlib.com`
133
+ - **[Complete 4-Octave F/Bb Double Horn Fingering Chart (C1–F6)](https://hornlib.com/fingerings)** — `https://hornlib.com/fingerings`
134
+ - **[7-in-1 French Horn Transposition, Drone Tuner & Harmonic Toolkit](https://hornlib.com/7-in-1-tools)** — `https://hornlib.com/7-in-1-tools`
135
+ - **[Full Horn Note Compass & Natural Overtone Harmonic Series Table](https://hornlib.com/all-notes)** — `https://hornlib.com/all-notes`
136
+ - **[Orchestral French Horn Audition Repertoire Excerpts Archive](https://hornlib.com/repertoire-excerpts)** — `https://hornlib.com/repertoire-excerpts`
137
+ - **[Beginner French Horn Embouchure, Kruspe vs Geyer Wrap & Mouthpieces](https://hornlib.com/beginners)** — `https://hornlib.com/beginners`
138
+ - **[French Horn Brass Acoustics, Stopped Horn (+), & Pedagogy Guides](https://hornlib.com/guides-pedagogy)** — `https://hornlib.com/guides-pedagogy`
76
139
 
77
140
  ---
78
141
 
79
- ## 📄 License
142
+ ## Source, Registries & License
80
143
 
81
- MIT © [HornLib (hornlib.com)](https://hornlib.com)
144
+ - **GitHub MCP Repository**: [https://github.com/HornLib/mcp-server](https://github.com/HornLib/mcp-server)
145
+ - **Official MCP Registry**: `com.hornlib/mcp`
146
+ - **OpenAPI 3.1 Specification**: [https://hornlib.com/openapi.json](https://hornlib.com/openapi.json)
147
+ - **License**: MIT © [HornLib (hornlib.com)](https://hornlib.com)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "hornlib-cli",
3
- "version": "1.0.3",
3
+ "version": "1.0.4",
4
4
  "description": "Official CLI & MCP client for HornLib (hornlib.com): look up French Horn F/Bb double horn valve fingerings (C1-F6), transpose orchestral horn keys, and analyze overtone harmonic series from your terminal.",
5
5
  "homepage": "https://hornlib.com",
6
6
  "repository": {