# poetry-mcp — 古诗文 MCP Server

> 古诗检索 + 背诵批改 + 赏析生成 + **唐诗宋词朗诵配音**（联动 TTS）。
> 面向：学生/家长/语文教育/古诗内容创作者。

## 演示

![操作演示](assets/demo_usage.gif)

![功能总览](assets/demo_overview.png)

![古诗字帖](assets/demo_calligraphy.png)

> 搜诗 → 批改 → 朗诵 → 字帖，古诗内容生产闭环

## 为什么做这个

- **`mcp 古诗` 搜索结果 = 0 命中**，纯蓝海
- 所有 LLM 引用古诗**必错朝代/作者**，是高频刚痛
- 古诗"朗诵→名句卡片→视频混剪"和教育内容生产是你的 MCP 生态闭环核心

## 核心能力

| 工具 | 说明 |
|---|---|
| `search_poems_tool` ⭐ | 按 标题/内容/作者/朝代/类别 全文检索 |
| `get_poem_detail` | 单篇全文 + 元数据 |
| `check_recitation_tool` ⭐ | 背诵/默写批改：对比原文，返回正确率+错误位置 |
| `appreciation_tool` | 赏析生成（规则引擎） |
| `recite_poem_tool` ⭐⭐ | **古诗朗诵配音**：联动 tts-mcp-server 生成朗读音频+字幕 |
| `make_calligraphy_tool` ⭐ | **单字字帖**：田字格/米字格 + 描红 + 笔顺 |
| `make_poem_sheet_tool` ⭐⭐ | **古诗字帖页**：整首诗生成描红练习页 |

## 生态协同（内容生产闭环）

```
poetry-mcp        古诗检索 → 朗诵配音 ← 名字卡片视频
tts-mcp-server    诗词 → 朗读音频（多引擎）
video-workflow    名句 → 卡片视频
```

## 示范

```
搜"明月" → 《静夜思》《水调歌头》
背"床前明月光，凝是地上霜..." → 批改 95%，错字在第5位
调 recite_poem(poem_id=1) → 云希男声朗诵《静夜思》+ 字幕
```

## 安装

```bash
pip install poetry-mcp-server
```

## 使用

```json
{
  "mcpServers": {
    "poetry": {
      "command": "poetry-mcp",
      "args": []
    }
  }
}
```

## Roadmap

- [x] P0: 内置精选库（统编必背16首）+ 检索/批改/赏析/朗诵
- [x] P1: 字帖生成（单字描红 + 整页古诗字帖）
- [ ] P2: 全唐诗/宋词/元曲批量导入 + 笔顺数据（make-me-a-hanzi）
- [ ] P3: LLM 深化赏析、名句卡片生成（联动证件照/视频）

## License

MIT。

---

## 系列（Chinese MCP Suite）

> 中文内容创作/工具 MCP 全家桶，全本地、CPU、离线：


- [tts-mcp-server](https://github.com/Gollum-code/tts-mcp-server) — TTS聚合+字幕对齐
- [idphoto-mcp](https://github.com/Gollum-code/idphoto-mcp) — 本地证件照
- [audio-post-mcp](https://github.com/Gollum-code/audio-post-mcp) — 音频后期
- [video-workflow-mcp](https://github.com/Gollum-code/video-workflow-mcp) — 视频工作流
- **poetry-mcp**（本仓库）— 古诗文
- [script-mcp](https://github.com/Gollum-code/script-mcp) — 口播文案
- [asset-mcp](https://github.com/Gollum-code/asset-mcp) — 素材库
- [idiom-mcp](https://github.com/Gollum-code/idiom-mcp) — 成语典故
- [weather-mcp](https://github.com/Gollum-code/weather-mcp) — 天气/空气