唐宋音乐文献深度解析 MCP Server

dhcckb-deep-parse-music-literature 是一个面向数字人文研究的 MCP Server，整合三大核心能力：

1. 智能实体标引 — Person/Tune/Structure/Instrument/Location 五类实体识别（词典 MMSeg 正则匹配为先、可选 PaddleNLP 后补），输出 entities（含 char_offset、confidence）和 key_sentences
2. 人事传播网络溯源 — 内置 20+ 位核心乐人/进献使臣基础信息（含身份等级、行为操作、朝代时间轴），女性乐人条件触发"被遮蔽的乐人群体"标签及社会学背景说明
3. 歌辞异文比对与杂言化分析 — 字数句式统计、杂言化指数 Mixed-verse Index 计算、版本异文高亮含字符偏移量、入破/急遍结构推断，所有结论附带精确到卷数与原始引文的 citations

依赖版本约束

本 Server 要求 MCP SDK >= 1.13.1 且 < 2.0.0，以确保与 Cherry Studio 等主流 MCP 客户端兼容。此约束已在 pyproject.toml 中声明：

"mcp>=1.13.1,<2.0.0"

安装与启动

方式一：uvx 一行启动（推荐）

uvx dhcckb-deep-parse-music-literature

uvx 会自动从 PyPI 拉取最新版本并解析依赖约束。

方式二：uvx 显式声明 MCP 版本（Cherry Studio 推荐）

在 Cherry Studio 的 MCP 配置中使用如下 JSON：

{
  "mcpServers": {
    "deep-parse-music-literature": {
      "command": "uvx",
      "args": ["dhcckb-deep-parse-music-literature"]
    }
  }
}

如果遇到 SDK 版本不兼容问题，可改用 uv run --with 显式声明：

{
  "mcpServers": {
    "deep-parse-music-literature": {
      "command": "uv",
      "args": ["run", "--with", "mcp>=1.13.1,<2.0.0", "--with", "dhcckb-deep-parse-music-literature", "dhcckb-deep-parse-music-literature"]
    }
  }
}

方式三：pip 安装

pip install 'mcp>=1.13.1,<2.0.0' dhcckb-deep-parse-music-literature
dhcckb-deep-parse-music-literature

方式四：uv tool install 全局安装

uv tool install --with 'mcp>=1.13.1,<2.0.0' dhcckb-deep-parse-music-literature
dhcckb-deep-parse-music-literature

SSE 模式启动

# 安装 SSE 可选依赖
uvx --with 'dhcckb-deep-parse-music-literature[sse]' dhcckb-deep-parse-music-literature --transport sse --port 8000

# 或 pip 方式
pip install 'dhcckb-deep-parse-music-literature[sse]'
dhcckb-deep-parse-music-literature --transport sse --port 8000

工具说明

deep_parse_music_literature

对输入的唐宋音乐文献全文进行三层深度解析。必填参数：

支持的 Python 版本

• Python 3.10+
• Python 3.11
• Python 3.12
• Python 3.13

许可证

MIT