twexam-mcp

台灣國家考試（考選部）歷屆試題查詢 MCP 伺服器，提供 20 個工具供 Claude Code / Claude Desktop 查題、練習、法條反查、考點分析、弱點複習、考試就緒度評估與考點重點提示。

安裝

# 1. 建立虛擬環境
py -m venv .venv

# 2. 安裝套件（可編輯模式）
.venv\Scripts\python -m pip install -e .

Related MCP server: ExamPrepAgent

在 Claude Code 中使用

Claude Code 會自動讀取專案根目錄的 .mcp.json，無需額外設定。 將本專案目錄加入 Claude Code 工作區後，twexam 伺服器即自動載入。

在 Claude Desktop 中使用

編輯 Claude Desktop 的 claude_desktop_config.json（位置依平台而定），加入：

{
  "mcpServers": {
    "twexam": {
      "command": "C:\\path\\to\\twexam-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "twexam_mcp.server"]
    }
  }
}

macOS / Linux 使用者： 將 command 改為 .venv/bin/python（POSIX 路徑），例如： "command": "/path/to/twexam-mcp/.venv/bin/python"

工具一覽

資料來源

本題庫資料來源為考選部公開資訊（政府公開資料），網域範圍：wwwq.moex.gov.tw、wwwc.moex.gov.tw。

本套件已內建完整歷屆題庫 twexam_mcp/data/questions.db（109–114 年司律一試／二試，共 1940 題），打包進 wheel 後即為自帶資料、安裝即用，毋須執行 ingestion（Playwright／連網）。若 DB 不存在，伺服器會退回 4 題示範種子（twexam_mcp/data/seed.json）。

題庫由 Plan 2 建置流程（python -m twexam_mcp.ingest.run）自考選部公開資料下載、解析後產生；該流程為選用相依（pip install -e ".[ingest]"），一般使用者不需安裝。

練習記錄存放位置： 弱點引擎（record_answer 等）的作答記錄與複習排程，寫入你本機安裝的 questions.db（attempts / review_state 表）。記錄是單機、個人的；重新安裝或升級 wheel 會覆蓋該 DB、清空練習記錄。若日後要保留升級前的進度，請先備份 questions.db。

打包為可散布套件

發佈版請用 scripts/build_release.py，它會在打包時清空個人練習記錄（attempts / review_state）， 再無條件還原你本機的完整 DB（try/finally 保證你的進度不會遺失）：

.venv\Scripts\python scripts\build_release.py
# 產生 dist\twexam_mcp-0.5.0-py3-none-any.whl（含完整題庫 DB、但不含你的作答史）
# 安裝後可用 console 指令 twexam-mcp 啟動，或 python -m twexam_mcp.server

直接 pip wheel . 也能打包，但會把你本機的作答記錄一起包進 wheel — 要散布給別人請用上面的 build script。

DISCLAIMER 免責聲明

• get_model_answer 所提供之 AI 擬答為機器自動生成，並非官方解答或任何主管機關之見解。

• 本伺服器之所有內容不得作為應試依據、法律意見或任何正式文件之引用。

• 考選部公告之標準答案與評分準則以官方公告為準，本工具不提供保證。

• 使用者應自行判斷資訊之準確性，作者及貢獻者不承擔任何因使用本工具所生之損失或法律責任。

授權

MIT License — 詳見 LICENSE。