School Timetable Builder

io.github.wilbek-source由 GitHub 帳號 wilbek-source 發布v1.0.0更新於 Oct 24, 2026

Build a full weekly timetable for a primary school (classes, teachers, rooms) via chat.

已驗證Streamable HTTP可網頁執行效率與工作流

概覽

AI 產生的概覽

一個遠端 MCP 伺服器,可依據透過對話提供的八個輸入檔案,產生完整的每週國小課表,並支援驗證與進度追蹤。

可以做什麼
取得訪談指南:回傳應向使用者提出的問題、預設值、引擎限制以及八個輸入檔案的确切格式,須優先呼叫。驗證輸入:在數秒內檢查檔案結構、引擎限制與教師和時間容量,回傳含警告的 VALID 或含原因的 INVALID。建立課表:啟動完整計算並立即回傳 job_id。查詢結果:輪詢工作狀態與進度,完成後取得依班級或依教師排列的精簡文字課表,以及一小時內有效的完整 JSON 結果連結。傳送意見回饋:將使用者本人對服務的意見轉交開發者。
適用情境
當國小需要一份涵蓋班級、教師與教室的完整每週課表,且使用者能依所需格式提供八個輸入檔案時使用。適合可接受數分鐘計算並輪詢進度的對話式排課情境。
執行需求
需要遠端 streamable HTTP 端點;未宣告任何套件、帳號、API 金鑰或環境變數。使用者須依訪談指南描述的确切格式提供八個輸入檔案,助理需輪詢取得結果。
安裝前請注意
計算約需五到八分鐘,需在同一回覆中反覆輪詢。完整 JSON 結果連結一小時後失效。意見回饋會傳送給開發者,因此僅在使用者要求時傳送,且不得包含教師姓名等個人資料。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 School Timetable Builder,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.wilbek-source%2Ftimetable-builder/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "school-timetable-builder": {
      "type": "http",
      "url": "https://timetable-builder.wilbek.workers.dev/mcp"
    }
  }
}

工具

5

get_interview_guide

Get interview guide

Returns the interview guide: which questions to ask the user, default values, engine limits and the exact format of the 8 input files. Call this first.

無需輸入參數。

validate_input

Validate input files (free)

Checks the 8 input files in a few seconds without creating a timetable: file structure, engine limits and a capacity analysis (enough teachers/time?). Returns VALID (with warnings) or INVALID (with reasons). Always run this before create_schedule.

輸入參數files必填user_countryuser_language

create_schedule

Create timetable

Starts calculating the full timetable from the 8 input files (validate them first). Returns a job_id at once; the calculation takes about 5-8 minutes. Then keep calling get_schedule_result with the job_id in the same reply until it is done.

輸入參數files必填user_countryuser_language

get_schedule_result

Get timetable result

Gets the status or result of a job from create_schedule (or a slow validate_input). While running: progress. When done: a compact timetable as text plus a link (valid 1 hour) to the full JSON result. view='classes' (default) = one table per class, 'teachers' = one per teacher incl. preparation time, 'summary' = key figures and lists of classes/teachers only. Use 'names' to get only some classes/teachers (recommended for big schools). If impossible: the reasons.

輸入參數viewnamesjob_id必填

send_feedback

Send feedback to the developer

Passes the user's feedback about the timetable service on to its developer (what worked, what did not, wishes). Only call it when the user has said they want to give feedback, and send what the user said in their own words (you may shorten it; any language is fine). Never include teacher names, other personal data or the school's data files. Tell the user briefly that it was sent. Nobody replies through this channel - if the user wants an answer, give them the support email [email protected].

輸入參數job_idmessage必填sentimentuser_countryuser_language

版本歷史

1
  1. v1.0.0最新Oct 16, 2026

評分

已滿足適用檢查項的 83%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。