Semantic + keyword teacher-cert question search

tw_search_teacher_exam_questions

TW-specificMIT

**關鍵字 / Keywords**: 教檢題目教資考選擇題師培題 teacher exam questions 幼兒園特教

以自然語言 + (可選) 關鍵字過濾, 檢索**教檢題目**級別.

Corpus: 教師資格考試 (教育部), 民國 094-115 選擇題逐題抽取 + Qwen3-
Embedding-4B 向量化. 約 ~3,000-4,000 題 (試題本含 selection question
部分; 申論/綜合/寫作題不抽取).

參數:
    query: 自然語言, 例「兒童認知發展階段」「特殊教育學生評量」
    stem_contains: 題幹必含此子字串 (硬性 keyword filter)
    exid / category_contains / subject_contains: 同 tw_search_teacher_exam
    year_from / year_to: 西元年範圍
    limit: top-K (1..100)

回傳 schema:
    {n_corpus, n_returned, query,
     hits: [{paper_id, exam_year (民國), exam_year_西元,
             exam_name, exid, category, subject_name,
             question_no, question_type, stem, options{A,B,C,D},
             answer, similarity}, ...]}

典型用法:
    tw_search_teacher_exam_questions("皮亞傑認知發展")
    tw_search_teacher_exam_questions("特殊兒童", category_contains="特殊")
    tw_search_teacher_exam_questions("教學評量", subject_contains="課程與教學",
                                  year_from=2020)

Input schema

{
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "stem_contains": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Stem Contains"
    },
    "exid": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Exid"
    },
    "category_contains": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category Contains"
    },
    "subject_contains": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Subject Contains"
    },
    "year_from": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Year From"
    },
    "year_to": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Year To"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "tw_search_teacher_exam_questionsArguments",
  "type": "object"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see tw_search_teacher_exam_questions. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 tw_search_teacher_exam_questions 處理 "…"。

# It will call:
tw_search_teacher_exam_questions(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs