Metadata-Version: 2.4
Name: dhcckb-guyin-mcp
Version: 0.1.0
Summary: 古音查询与标注 MCP Server — 通过韵典网检索上古音系、廣韻、中原音韻、洪武正韻牋、分韻撮要，提供汉字音韵信息查询与连续文本标注
Author: Digital Humanities Platform
License: MIT
Keywords: ancient-chinese,mcp,phonology,rhyme-dictionary,ytenx
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: lxml>=5.0.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: openpyxl>=3.1.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# 古音查询与标注 MCP Server

通过 [韵典网](https://ytenx.org/) 检索上古音系、廣韻、中原音韻、洪武正韻牋、分韻撮要五部韵书，为汉字提供声母、韵部、声调、等呼、反切、拟音、释义等完整音韵信息。支持单字/多音字查询和连续文本标注。

## 支持的韵书

| ID | 名称 | 年代 |
|----|------|------|
| shanggu | 上古音系 | 先秦 |
| guangyun | 廣韻 | 北宋 |
| zhongyuan | 中原音韻 | 元代 |
| hongwu | 洪武正韻牋 | 明代 |
| fenyun | 分韻撮要 | 清代 |

## 工具

- **query_character**: 查询单个汉字在指定韵书中的全部音韵信息
- **annotate_text**: 对连续文本逐字标注音韵信息，支持多种输出格式
- **list_dictionaries**: 列出支持的韵书清单
- **search_by_pronunciation**: 按音韵特征反查同音或音近字
- **textual_interpretation**: 多音字根据上下文进行读音推荐

## 安装

```bash
uvx dhcckb-guyin-mcp
```

## MCP 客户端配置

```json
{
  "mcpServers": {
    "guyin": {
      "command": "uvx",
      "args": ["dhcckb-guyin-mcp"]
    }
  }
}
```
