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.
- package/README.md +99 -33
- 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
|
-
[](https://hornlib.com)
|
|
4
|
+
[](https://www.mcptry.com/servers/com.hornlib/mcp)
|
|
5
5
|
[](https://glama.ai/mcp/connectors/com.hornlib/mcp)
|
|
6
6
|
[](https://clawhub.ai/hornlib/skills/hornlib)
|
|
7
7
|
[](./LICENSE)
|
|
8
8
|
|
|
9
|
-
Official command-line interface and
|
|
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
|
-
##
|
|
13
|
+
## Quick Start (`npx`)
|
|
14
14
|
|
|
15
|
-
Run directly
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
##
|
|
43
|
+
## Available MCP Tools (8 Read-Only Tools)
|
|
44
44
|
|
|
45
|
-
|
|
|
46
|
-
| :--- | :--- | :--- |
|
|
47
|
-
|
|
|
48
|
-
|
|
|
49
|
-
|
|
|
50
|
-
|
|
|
51
|
-
|
|
|
52
|
-
|
|
|
53
|
-
|
|
|
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
|
-
##
|
|
58
|
+
## Live Production Verification Sample
|
|
58
59
|
|
|
59
|
-
|
|
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
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
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
|
-
##
|
|
142
|
+
## Source, Registries & License
|
|
80
143
|
|
|
81
|
-
|
|
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
|
+
"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": {
|