古代音乐文献研究 MCP Server
dhcckb-ancient-music-mcp 是一个面向古代音乐文献研究的 MCP (Model Context Protocol) Server，让 AI Agent 能通过标准化工具检索先秦至明清的音乐典籍、释义专业术语（律吕/宫调/谱式）、转换传统乐谱（工尺谱/减字谱）、分析律制体系（三分损益/十二平均律/京房六十律）、以及查询中国传统乐器信息。
功能概览
| 工具 | 功能 |
|---|---|
search_music_literature |
古代音乐文献全文检索（支持中/英/日多语言） |
lookup_musicology_term |
音乐学专业术语释义与文献引文查询 |
convert_gongche_to_staff |
工尺谱转科学音高/简谱/ABC Notation |
convert_jianzipu_to_modern |
减字谱字符解析（指法/弦位/徽位提取） |
analyze_tuning_system |
律制体系数学分析（三分损益/十二平均律/京房六十律等） |
get_instrument_info |
中国传统乐器信息查询（八音分类/形制/曲目） |
安装
从 PyPI 安装
pip install dhcckb-ancient-music-mcp
从源码安装（开发模式）
git clone <repo-url>
cd dhcckb-ancient-music-mcp
pip install -e .
要求 Python 3.10 或更高版本。
Claude Desktop 接入
在 claude_desktop_config.json 中添加：
{
"mcpServers": {
"ancient-music-mcp": {
"command": "uvx",
"args": ["dhcckb-ancient-music-mcp"]
}
}
}
工具说明
search_music_literature
在古代音乐文献语料库中按关键词、朝代、作者、体裁进行全文检索。支持中/英/日多语言检索，自动扩展同义词。
lookup_musicology_term
查阅音乐学专业术语的释义、最早出处、同义/关联术语及相关原始文献引文。覆盖音律、乐谱、乐制、乐器四类核心术语。
convert_gongche_to_staff
将工尺谱字符串转换为现代记谱法。同时输出科学音高记号（如 C4/D4）、简谱（数字谱）、ABC Notation 文本（可用于 LilyPond/abc2svg 渲染五线谱）及 MIDI 音高编号。
convert_jianzipu_to_modern
解析古琴减字谱字符，提取右手弹奏指法、左手按弦指法、弦序、徽位及特殊技法。
analyze_tuning_system
分析指定律制体系的数学比例与音高关系。支持三分损益法、十二平均律、京房六十律、钱乐之三百六十律、何承天新律五种律制。
get_instrument_info
查询中国传统乐器的基本信息，包括八音类别、起源朝代、形制描述、代表性曲目与演奏家、关联文献出处。
许可
MIT License
1 maintainer
Metadata
1 maintainer
Release files for dhcckb-ancient-music-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dhcckb_ancient_music_mcp-0.1.1.tar.gz | 40.2 kB | Details |
Release files / dhcckb_ancient_music_mcp-0.1.1.tar.gz
| Download URL | dhcckb_ancient_music_mcp-0.1.1.tar.gz |
|---|---|
| Size | 40.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
67d9c6649fa1e9c568b3a57fe24e073097d87c210e9dd1b841a879b60350a7d4
|
|
BLAKE2b-256 checksum How to use checksums |
3bdea1adcc2385f5d2b8f0c94f2bfdd6b459a22e3ed72c63cc5a5a2c12f2963f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
Bun/1.3.13
|
