# 法考题库 MCP Server (fakao-mcp)

2026 法考备考题库 — **2,027 道历年真题 + 章节练习**，基于艾宾浩斯遗忘曲线安排复习节奏，通过 MCP 协议暴露为 AI 可直接调用的刷题工具。

> 本 MCP Server 由 [Hermes Agent](https://hermes-agent.nousresearch.com) 制作。使用其他 AI Agent（Claude Code、Codex、Cursor 等）的用户需要自行适配 MCP 客户端，本仓库不保证兼容性。

## 快速开始

```bash
git clone https://github.com/mleen/fakao-mcp
cd fakao-mcp
pip install -r requirements.txt
hermes mcp add fakao --command "python $(pwd)/mcp_server.py"
```

重启 Hermes 后，`fa kao_*` 工具自动出现在工具列表中。

> ⚠️ **注意**：必须用 `hermes mcp add` 命令注册，**不要**让 AI Agent 直接编辑 `~/.hermes/config.yaml`。Hermes 会阻止 AI 修改安全敏感配置，这是正常的安全防护。

## MCP 工具

| 工具 | 说明 |
|------|------|
| `search_questions` | 搜索题目（关键词 + 科目筛选） |
| `get_practice` | 随机抽题练习 |
| `check_answer` | 核对答案 + 显示解析 |
| `get_stats` | 题库统计 |
| `get_subjects` | 科目列表 |
| `export_json` | 导出完整题库 JSON |

## 使用方式

**推荐：Hermes 后台伺服 + 移动端刷题**

MCP Server 在本地或服务器上后台运行，通过 Hermes Gateway 接入微信 ClawBot、飞书、Telegram、Discord 等平台。出门掏出手机就能刷题，无需开电脑。

```bash
# 启动 Hermes Gateway（后台驻留）
hermes gateway start
```

配置好对应平台后，在聊天窗口直接说：
- 「抽 5 道刑法题给我做」→ 自动调 `get_practice`
- 「第一题选 B，帮我看看对不对」→ 自动调 `check_answer`
- 「搜一下正当防卫的题」→ 自动调 `search_questions`

无需记命令，自然语言即可。

## 刷题策略

系统内置的 SM-2 算法（源自 SuperMemo）遵循艾宾浩斯遗忘曲线规律：

- **新题** → 按 1天、3天、7天、15天、30天 间隔自动安排复习
- **做错的题** → 重置为 1天，密集强化直到掌握
- **熟练的题** → 间隔拉长到数月，避免无效重复

这套策略让有限的时间花在真正需要巩固的知识点上，而不是均匀撒网。

## 更新题库

```bash
git pull
```

题库文件 `data/fakao.db` 和 `data/fakao.json` 同步更新。

## JSON 格式

`data/fakao.json`（1.8MB，纯文本可 diff/merge）方便社区协作：

```json
{
  "version": "1.0.0",
  "total": 2027,
  "questions": [
    {
      "id": 1,
      "stem": "题干",
      "options": {"A": "选项A", "B": "选项B", "C": "选项C", "D": "选项D"},
      "answer": "B",
      "analysis": "解析内容",
      "question_type": "单选",
      "difficulty": 3,
      "year": 2025,
      "source": "zhu",
      "subject": "刑法",
      "chapter": ""
    }
  ]
}
```

其他用户提取新题后，可合并到 `fakao.json`，提交 PR 同步到主仓库。

## 数据来源

- 网络共享资源

## 科目分布

| 科目 | 题数 |
|------|------|
| 刑法 | 1,689 |
| 刑诉 | 110 |
| 民法 | 105 |
| 宪法 | 49 |
| 理论法 | 62 |
| 行政法 | 75 |
| 其他 | 62 |
| **合计** | **2,027** |