# 🏮 TCM MCP Server

倪海厦经方体系 · AI中医知识引擎

通过 MCP (Model Context Protocol) 协议，让 AI 助手获得专业中医知识：草药查询、方剂检索、针灸取穴、六经辨证。

## 特性

- 🌿 **15味核心经方草药** — 性味归经/功效/经典药对/倪师注解
- 📜 **14首伤寒金匮核心方** — 组成/适应证/六经归属/方歌/禁忌
- 📍 **13个常用穴位** — 定位/针法/主治/四总穴诀
- 🏥 **六经辨证框架** — 输入症状→判定经证→推荐方剂
- ⚠️ **配伍禁忌检查** — 十八反/十九畏

## 安装

```bash
pip install -e .
```

或

```bash
uv pip install -e .
```

## 使用

### 接入 Claude Code

在 `settings.json` 中添加：

```json
{
  "mcpServers": {
    "tcm": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/tcm-mcp-server", "tcm-mcp"]
    }
  }
}
```

### 可用工具

| 工具 | 功能 | 示例 |
|------|------|------|
| `search_herbs` | 搜索草药 | "桂枝", "解表", "温里", "头痛" |
| `search_formulas` | 搜索方剂 | "小柴胡汤", "太阳病", "失眠" |
| `search_acupoints` | 搜索穴位 | "足三里", "胃经", "腰痛", "肚腹" |
| `diagnose_six_channel` | 六经辨证 | "发热恶寒汗出脉浮缓" |
| `get_formula_compatibility` | 配伍禁忌检查 | ["附子", "半夏", "甘草"] |
| `get_tcm_overview` | 知识体系概览 | （无参数） |

### 可用 Resources

- `tcm://categories/herbs` — 草药按功效分类
- `tcm://categories/formulas` — 方剂按功效分类
- `tcm://meridians` — 穴位按经络分类
- `tcm://six-channels` — 六经辨证完整框架

### 可用 Prompts

- `tcm-diagnosis` — 辅助中医辨证论治
- `formula-analysis` — 分析方剂组成和配伍规律

## 数据来源

基于倪海厦（1954-2012）汉唐中医体系：
- 《伤寒论》六经辨证
- 《金匮要略》杂病证治
- 《神农本草经》药物体系
- 《针灸大成》经络腧穴
- 扶阳理论、汉唐处方体系

## 路线图

- [x] 核心草药/方剂/穴位数据
- [x] 六经辨证诊断工具
- [x] 配伍禁忌检查
- [ ] 更多草药和方剂（目标100+味草药，50+首方）
- [ ] 医案数据库（症状→方剂疗效）
- [ ] 舌诊/脉诊辅助描述
- [ ] Web 界面（面向中医学生的AI学习工具）

## 许可

MIT