# idiom-mcp — 成语典故 MCP Server

> 成语检索 + 释义 + 出处 + 近反义词 + 造句 + **AI 易错提醒**。
> 数据源：chinese-xinhua（MIT，**30,895 条成语**，含释义/拼音/出处/例句）。

## 演示

![AI成语易错提醒](assets/demo_misuse.png)

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

> 内置 14 个高频误用成语对照表，AI 引用成语时自动提醒正确含义

## 为什么做这个

- **`mcp 成语` 搜索结果 = 0 命中**，纯蓝海
- **AI 引用成语错误率极高**（乱造/用错语境/解释错出处）——这是高频刚痛
- 与古诗文 MCP 形成"**写对、用对、引对**"内容创作双核：
  - 古诗文管"**引对**"——原文、作者、全诗全文
  - 成语管"**写对用对**"——查释义/造句防用错，引前查出处防张冠李戴

## 核心能力

| 工具 | 说明 |
|---|---|
| `search_idiom_tool` | 按 词形/拼音/释义 模糊检索（30,895条） |
| `lookup_idiom_tool` ⭐ | 完整释义 + 拼音 + 出处 + 例句 + 易错提醒 |
| `get_origin_tool` | 成语典故出处单独返回 |
| `get_synonyms_antonyms_tool` | 近反义词 |
| `make_sentence_tool` | 造句（原文例句 或 模板句） |
| `check_misuse_tool` ⭐⭐ | **AI 易错提醒**：命中则警告本义 + 常见误用 |

## AI 易错对照表（内置14个高频误用）

| 成语 | 正确含义 | 常见误用 |
|---|---|---|
| 炙手可热 | 权势大、气焰盛 | "人红/事业火" |
| 空穴来风 | 消息传播不是没原因的 | "毫无根据" |
| 差强人意 | 勉强使人满意 | "差劲" |
| 首当其冲 | 最先受攻击/遭灾 | "首先/带头冲锋" |
| 万人空巷 | 家家户户都出来庆祝 | "街上没人" |
| 不刊之论 | 不可修改的正确言论 | "不能刊登的言论" |
| 七月流火 | 天气转凉 | "七月天气炎热" |

## 生态协同

```
idiom-mcp        查成语/防用错
poetry-mcp       引古诗/保出处
script-mcp       写文案用对成语
→ 内容创作"写对、用对、引对"三保险
```

## 安装

```bash
pip install idiom-mcp-server
python -m build_db   # 首次构建 SQLite 索引（30,895条）
```

## 使用

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

## Roadmap

- [x] P0: 检索/释义/出处/近反义词/造句/易错提醒（30,895条数据）
- [ ] P1: 近反义词全量补齐、典故来源（春秋/战国/史记）标注
- [ ] P2: 与古诗文联动（"成语出处 → 查原文"）

## License

MIT。数据源 chinese-xinhua（MIT，30,895条成语，注明来源即可商用）。

---

## 系列（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](https://github.com/Gollum-code/poetry-mcp) — 古诗文
- [script-mcp](https://github.com/Gollum-code/script-mcp) — 口播文案
- [asset-mcp](https://github.com/Gollum-code/asset-mcp) — 素材库
- **idiom-mcp**（本仓库）— 成语典故
- [weather-mcp](https://github.com/Gollum-code/weather-mcp) — 天气/空气