hornlib-cli 0.0.0-stage → 1.0.3
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/LICENSE +21 -0
- package/README.md +80 -2
- package/bin/hornlib.mjs +105 -0
- package/package.json +46 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 HornLib (https://hornlib.com)
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,81 @@
|
|
|
1
|
-
#
|
|
1
|
+
# hornlib-cli — French Horn Fingering Chart, Transposition & Harmonics CLI (`hornlib.com`)
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://hornlib.com)
|
|
4
|
+
[](https://www.mcptry.com/servers/com.hornlib/mcp)
|
|
5
|
+
[](https://glama.ai/mcp/connectors/com.hornlib/mcp)
|
|
6
|
+
[](https://clawhub.ai/hornlib/skills/hornlib)
|
|
7
|
+
[](./LICENSE)
|
|
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.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## ⚡ Quick Start (`npx`)
|
|
14
|
+
|
|
15
|
+
Run directly without installation:
|
|
16
|
+
|
|
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
|
|
20
|
+
|
|
21
|
+
# Transpose written horn pitch across historical crooks (F, Bb, Eb, D, C, G, A)
|
|
22
|
+
npx hornlib-cli transpose C5 Eb
|
|
23
|
+
|
|
24
|
+
# Inspect natural overtone harmonic series partials & equal-temperament cent deviations
|
|
25
|
+
npx hornlib-cli harmonics open F
|
|
26
|
+
|
|
27
|
+
# Retrieve orchestral horn audition excerpt performance guides
|
|
28
|
+
npx hornlib-cli excerpt "Strauss Till Eulenspiegel"
|
|
29
|
+
|
|
30
|
+
# Generate a structured daily brass warmup routine
|
|
31
|
+
npx hornlib-cli warmup 30 intermediate
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Or install globally:
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
npm install -g hornlib-cli
|
|
38
|
+
hornlib fingering C5
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 🌐 Interactive Web Tools on [hornlib.com](https://hornlib.com)
|
|
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 |
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## 🤖 AI Agent & MCP Server Integration (`com.hornlib/mcp`)
|
|
58
|
+
|
|
59
|
+
Connect Claude Desktop, Claude Code, Cursor, Windsurf, Hermes Agent, or OpenClaw directly to HornLib's stateless Streamable HTTP MCP endpoint:
|
|
60
|
+
|
|
61
|
+
```json
|
|
62
|
+
{
|
|
63
|
+
"mcpServers": {
|
|
64
|
+
"hornlib": {
|
|
65
|
+
"type": "streamable-http",
|
|
66
|
+
"url": "https://hornlib.com/api/mcp"
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
```
|
|
71
|
+
|
|
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)
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## 📄 License
|
|
80
|
+
|
|
81
|
+
MIT © [HornLib (hornlib.com)](https://hornlib.com)
|
package/bin/hornlib.mjs
ADDED
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
const ENDPOINT = 'https://hornlib.com/api/mcp';
|
|
4
|
+
|
|
5
|
+
const HELP = `
|
|
6
|
+
🎺 HornLib CLI v1.0.3 — Interactive French Horn F/Bb Double Horn Studio
|
|
7
|
+
Official Web Studio: https://hornlib.com
|
|
8
|
+
Fingering Chart: https://hornlib.com/fingerings
|
|
9
|
+
7-in-1 Brass Tools: https://hornlib.com/7-in-1-tools
|
|
10
|
+
|
|
11
|
+
Usage:
|
|
12
|
+
npx hornlib-cli fingering <note> [double|f|bb] Look up F/Bb valve fingerings (e.g. C4, G4, C5, F5)
|
|
13
|
+
npx hornlib-cli transpose <note> <fromKey> Transpose horn pitch (F, Bb, Eb, D, C, G, A)
|
|
14
|
+
npx hornlib-cli harmonics [combination] Analyze overtone harmonic series partials (e.g. open, 1, 12)
|
|
15
|
+
npx hornlib-cli trill <fromNote> <toNote> Find valve & lip trill combinations
|
|
16
|
+
npx hornlib-cli excerpt <work> Retrieve orchestral audition excerpt guide (e.g. ತಿಲ್ಲ, mozart4)
|
|
17
|
+
npx hornlib-cli warmup [minutes] Generate daily brass warmup routine (default: 30)
|
|
18
|
+
npx hornlib-cli tools List all 8 HornLib MCP tools
|
|
19
|
+
`;
|
|
20
|
+
|
|
21
|
+
async function callMcpTool(name, args = {}) {
|
|
22
|
+
const res = await fetch(ENDPOINT, {
|
|
23
|
+
method: 'POST',
|
|
24
|
+
headers: { 'Content-Type': 'application/json', 'Accept': 'application/json' },
|
|
25
|
+
body: JSON.stringify({
|
|
26
|
+
jsonrpc: '2.0',
|
|
27
|
+
id: 1,
|
|
28
|
+
method: 'tools/call',
|
|
29
|
+
params: { name, arguments: args }
|
|
30
|
+
})
|
|
31
|
+
});
|
|
32
|
+
if (!res.ok) {
|
|
33
|
+
throw new Error(`HTTP ${res.status} from ${ENDPOINT}`);
|
|
34
|
+
}
|
|
35
|
+
const data = await res.json();
|
|
36
|
+
const text = data?.result?.content?.[0]?.text;
|
|
37
|
+
if (text) {
|
|
38
|
+
try {
|
|
39
|
+
return JSON.stringify(JSON.parse(text), null, 2);
|
|
40
|
+
} catch {
|
|
41
|
+
return text;
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
return JSON.stringify(data, null, 2);
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
async function listMcpTools() {
|
|
48
|
+
const res = await fetch(ENDPOINT, {
|
|
49
|
+
method: 'POST',
|
|
50
|
+
headers: { 'Content-Type': 'application/json', 'Accept': 'application/json' },
|
|
51
|
+
body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'tools/list', params: {} })
|
|
52
|
+
});
|
|
53
|
+
const data = await res.json();
|
|
54
|
+
return data?.result?.tools || [];
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
async function main() {
|
|
58
|
+
const [, , cmd, arg1, arg2] = process.argv;
|
|
59
|
+
if (!cmd || cmd === '--help' || cmd === '-h' || cmd === 'help') {
|
|
60
|
+
console.log(HELP.trim());
|
|
61
|
+
return;
|
|
62
|
+
}
|
|
63
|
+
if (cmd === '--version' || cmd === '-v') {
|
|
64
|
+
console.log('1.0.3');
|
|
65
|
+
return;
|
|
66
|
+
}
|
|
67
|
+
if (cmd === 'tools') {
|
|
68
|
+
const tools = await listMcpTools();
|
|
69
|
+
for (const t of tools) {
|
|
70
|
+
console.log(`- ${t.name}: ${t.description}`);
|
|
71
|
+
}
|
|
72
|
+
console.log('\nWeb Reference: https://hornlib.com');
|
|
73
|
+
return;
|
|
74
|
+
}
|
|
75
|
+
if (cmd === 'fingering') {
|
|
76
|
+
console.log(await callMcpTool('lookup_french_horn_fingering', { note: arg1 || 'G4', hornType: arg2 || 'double' }));
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
if (cmd === 'transpose') {
|
|
80
|
+
console.log(await callMcpTool('transpose_french_horn_pitch', { note: arg1 || 'C5', fromKey: arg2 || 'F', toKey: 'Concert' }));
|
|
81
|
+
return;
|
|
82
|
+
}
|
|
83
|
+
if (cmd === 'harmonics') {
|
|
84
|
+
console.log(await callMcpTool('analyze_horn_harmonic_series', { valveCombination: arg1 || 'open', hornSide: arg2 || 'F' }));
|
|
85
|
+
return;
|
|
86
|
+
}
|
|
87
|
+
if (cmd === 'trill') {
|
|
88
|
+
console.log(await callMcpTool('lookup_horn_trill_fingering', { baseNote: arg1 || 'G4', upperNote: arg2 || 'A4' }));
|
|
89
|
+
return;
|
|
90
|
+
}
|
|
91
|
+
if (cmd === 'excerpt') {
|
|
92
|
+
console.log(await callMcpTool('get_orchestral_horn_excerpt_guide', { query: arg1 || 'Strauss Till Eulenspiegel' }));
|
|
93
|
+
return;
|
|
94
|
+
}
|
|
95
|
+
if (cmd === 'warmup') {
|
|
96
|
+
console.log(await callMcpTool('generate_daily_horn_warmup_routine', { durationMinutes: Number(arg1) || 30, level: arg2 || 'intermediate' }));
|
|
97
|
+
return;
|
|
98
|
+
}
|
|
99
|
+
console.log(HELP.trim());
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
main().catch((err) => {
|
|
103
|
+
console.error('Error:', err.message);
|
|
104
|
+
process.exit(1);
|
|
105
|
+
});
|
package/package.json
CHANGED
|
@@ -1,6 +1,48 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "hornlib-cli",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "1.0.3",
|
|
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
|
+
"homepage": "https://hornlib.com",
|
|
6
|
+
"repository": {
|
|
7
|
+
"type": "git",
|
|
8
|
+
"url": "git+https://github.com/HornLib/hornlib-cli.git"
|
|
9
|
+
},
|
|
10
|
+
"bugs": {
|
|
11
|
+
"url": "https://github.com/HornLib/hornlib-cli/issues",
|
|
12
|
+
"email": "admin@hornlib.com"
|
|
13
|
+
},
|
|
14
|
+
"funding": {
|
|
15
|
+
"type": "individual",
|
|
16
|
+
"url": "https://hornlib.com"
|
|
17
|
+
},
|
|
18
|
+
"license": "MIT",
|
|
19
|
+
"author": "HornLib <admin@hornlib.com> (https://hornlib.com)",
|
|
20
|
+
"type": "module",
|
|
21
|
+
"bin": {
|
|
22
|
+
"hornlib": "bin/hornlib.mjs",
|
|
23
|
+
"hornlib-cli": "bin/hornlib.mjs"
|
|
24
|
+
},
|
|
25
|
+
"files": [
|
|
26
|
+
"bin/",
|
|
27
|
+
"README.md",
|
|
28
|
+
"LICENSE"
|
|
29
|
+
],
|
|
30
|
+
"engines": {
|
|
31
|
+
"node": ">=18.0.0"
|
|
32
|
+
},
|
|
33
|
+
"keywords": [
|
|
34
|
+
"french-horn",
|
|
35
|
+
"fingering-chart",
|
|
36
|
+
"hornlib",
|
|
37
|
+
"music-theory",
|
|
38
|
+
"brass",
|
|
39
|
+
"transposition",
|
|
40
|
+
"harmonic-series",
|
|
41
|
+
"orchestral-excerpts",
|
|
42
|
+
"mcp",
|
|
43
|
+
"cli",
|
|
44
|
+
"claude",
|
|
45
|
+
"cursor",
|
|
46
|
+
"openclaw"
|
|
47
|
+
]
|
|
48
|
+
}
|