关于 HornLib — Interactive French Horn F/Bb Double Horn Fingering & Harmonics Engine
HornLib 是面向圆号演奏者、教师和铜管乐学生的参考与分析服务。它通过托管的只读 MCP 服务提供指法、移调、泛音列数据和练习指导。
主要功能
- 01查询 F 调与 Bb 调圆号指法
- 02移调历史圆号声部
- 03分析泛音分音与音准
- 04查询颤音指法和试奏指南
- 05生成每日热身练习
适用场景
- 01比较某个书写音的阀门方案
- 02将旧式调号声部转为 F 调圆号
- 03研究泛音分音的音准倾向
- 04准备管弦乐试奏片段
MCP 相关
通过托管的 Streamable HTTP MCP 端点提供八种公开只读音乐参考工具。调用无需登录或 API 密钥。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://hornlib.com/api/mcpclaude mcp add --transport http com-hornlib https://hornlib.com/api/mcp{"mcpServers":{"com-hornlib":{"type":"http","url":"https://hornlib.com/api/mcp"}}}在 Cursor 中打开{"servers":{"com-hornlib":{"type":"http","url":"https://hornlib.com/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-hornlib":{"type":"http","url":"https://hornlib.com/api/mcp"}}}{"mcpServers":{"com-hornlib":{"serverUrl":"https://hornlib.com/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
HornLib — 交互式法国圆号 F/Bb 双调圆号指法与泛音引擎(com.hornlib/mcp)
数字化法国圆号指法表与移调铜管乐谱。
**HornLib(hornlib.com)**提供单 F 调、单 Bb 调和完整双调圆号(F/Bb 转调键)的交互式指法表、自然泛音列列表、历史管圈移调功能以及管弦乐试音片段指南,并通过位于https://hornlib.com/api/mcp的无状态streamable-httpModel Context Protocol (MCP) 服务向 AI Agent 提供这些功能。
🖥️ 交互式 Web 工作室预览
圆号演奏者与铜管乐教育者为何选择 HornLib
- 交互式双调圆号转调键切换:可在乐器四个八度的音域(
C1–F6)内,动态切换单 F 调圆号、单 Bb 调圆号和完整双调圆号(F/Bb 转调键)的活塞组合。 - 泛音分音的音准偏差图表:显示相对于平均律的精确音分偏差趋势(例如,第 5 分音为
-14 cents,第 7 分音为-31 cents,第 11 分音为-49 cents),并列出替代活塞方案。 - 历史管弦乐管圈移调:帮助圆号演奏者阅读古典与浪漫主义时期的管弦乐分谱,涵盖 F 调圆号、Bb 高音、Bb 低音、Eb、D、C 低音、G、A 和 E。
🛠️ 8 个只读 MCP 工具(https://hornlib.com/api/mcp)
全部 8 个工具均严格只读(readOnlyHint: true、destructiveHint: false、idempotentHint: true),且无需登录,也无需 API 密钥:
| # | 工具名称 | 功能与音乐理论范围 | 网页参考 |
|---|---|---|---|
| 1 | lookup_french_horn_fingering | 查询任意记谱音符(C1–F6)的 F 调管与 Bb 调触发阀指法、实音移调和音准倾向。 | 指法表 |
| 2 | transpose_french_horn_pitch | 将历史调管(F、Bb、Eb、D、C、G、A、E)的管弦乐圆号声部移调为现代 F 调圆号和实音。 | 七合一铜管乐器工具 |
| 3 | analyze_horn_harmonic_series | 分析任意 F 调或 Bb 调阀门组合的自然泛音列分音(第 1–16 泛音)、音分偏差和管长。 | 所有音符与泛音 |
| 4 | lookup_horn_trill_fingering | 判断全音和半音装饰音使用机械阀门颤音还是维也纳式泛音唇颤音。 | 颤音指法 |
| 5 | get_orchestral_horn_excerpt_guide | 提供莫扎特第四圆号协奏曲、施特劳斯《蒂尔·奥伊伦施皮格尔》、柴可夫斯基第五交响曲、勃拉姆斯和马勒作品的试奏准备提示、调管转换和指法。 | 管弦乐选段 |
| 6 | diagnose_horn_intonation_and_hand_position | 对阻塞音(gestopft,F 调圆号移调 +1/2 音)和右手罩钟方式进行声学诊断。 | 教学指南 |
| 7 | recommend_beginner_horn_and_mouthpiece | 比较 Kruspe 缠管式(Conn 8D)与 Geyer 缠管式(Alexander 103 / Yamaha),以及不同号嘴杯深(Farkas、Laskey、Schilke)。 | 入门指南 |
| 8 | generate_daily_horn_warmup_routine | 生成结构化的每日热身练习,涵盖 Farkas 长音、泛音唇滑音、吐音和低音。 | 知识库 |
⚡ 在 Hermes Agent 中安装
此仓库是面向 Hermes Agent 的纯配置 Agent Plugins v1 软件包(plugin.json、mcp.json 和 skills/)。
hermes plugins install hornlib
或直接从 GitHub 安装:
hermes plugins install HornLib/mcp-server
Hermes 中的提示词示例
- “查询记谱高音 A5 的 F/Bb 双调圆号主指法和替代指法。”
- “将 Eb 调圆号记谱 G4 移调为现代 F 调圆号和实音。”
- “比较开放 F 调圆号与开放 Bb 调圆号的泛音列分音和音分偏差。”
- “告诉我施特劳斯《蒂尔·奥伊伦施皮格尔》开篇圆号号角段的调性、速度和练习建议。”
⚡ 快速设置(Claude Desktop / Claude Code / Cursor / Windsurf / Skills CLI)
安装 Agent Skill(skills.sh)
npx skills add HornLib/mcp-server
直接远程 streamable-http 连接
{
"mcpServers": {
"hornlib": {
"type": "streamable-http",
"url": "https://hornlib.com/api/mcp"
}
}
}
Claude Code CLI
claude mcp add --transport http hornlib https://hornlib.com/api/mcp
🔒 安全与数据披露(Hermes Catalog 规则 13)
- 仅托管、仅配置的软件包:此仓库仅提供静态 JSON 清单(
plugin.json、mcp.json)和 Markdown 技能(skills/)。其中没有本地可执行代码、没有 Python 运行时、没有 shell 钩子、没有编译后的二进制文件、没有遥测收集器,也没有自动更新程序。 - 网络:每次 MCP 工具调用都会通过 HTTPS(
streamable-http)连接到 HornLib 托管的端点https://hornlib.com/api/mcp,且仅发送音乐查询参数(例如音符名称、圆号调性或选段名称)。远程工具清单由hornlib.com在运行时提供,不会由固定的提交 SHA 冻结。 - 无需凭据或登录:全部 8 个工具均免费向公众开放。不会读取或存储 API 密钥、OAuth 令牌、环境变量或本地文件。
- 只读与不受信任的防护机制:
https://hornlib.com/api/mcp上的所有工具都严格为只读(readOnlyHint: true、destructiveHint: false)。此软件包在plugin.json中将服务标记为trust: untrusted(extensions.com.nousresearch.hermes.servers.hornlib.trust = "untrusted"),因此如果将来公布了任何非只读工具,Hermes 会强制执行审批流程。 - 隐私与条款:隐私政策 · 使用条款
🔗 官方资源与深层链接
由铜管乐教育专家精心整理的音乐教育资源。MIT 许可证 © HornLib (hornlib.com)。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。


