第一個正式 release。這個服務從 2026-07-28 起就在線上跑,0.2.0 是 Workers 版第一個
commit 設的版本號,之後 37 個 commit 從沒動過——這次一併整理。
使用者感受得到的改動
工具清單現在可以被快取(modern era,public / 1 小時)。SDK 預設是不可快取、僅限單一
client,而這份清單執行期永不改變,那個預設對一個公開唯讀服務是最壞值。代價是工具描述的
修改最久要一小時才會傳到已快取的 client。
twse_search_datasets 的負數 limit 行為修正。 先前 limit: -1 會靜靜回傳 142/143
筆(少最後一筆),因為 slice(0, -1) 的語意是「除了最後一筆以外全部」。-1 是很常見的
「不限筆數」慣用寫法,模型用它不會收到任何錯誤。現在夾成 0 筆,total_matched 仍照實回報。
其餘皆不改變對外行為。
協定
同一個 /mcp 端點同時服務兩代 MCP 協定——legacy(2025-11-25 及更早)與 modern
(2026-07-28)。舊 client 不受影響,測試對兩個 era 各跑一遍守著。
值得記下來的是:2026-07-28 是破壞性改版(取消 initialize 交握與 session,改為每個請求
自帶 _meta envelope,並新增 server/discover 等強制義務),但本專案協定層一行都沒改
——那些義務全部由 MCP SDK 自動履行。詳見 docs/adr/0001-dual-era-and-cache-scope.md。
文件
- 五種語言:繁中、英、日、韓、簡中。日韓為機器翻譯並在檔案裡標明,歡迎 PR 修正。
- 兩份完整版之間、以及與三份精簡版的結構一致性由 CI 守著(
npm run check-readmes)。 - 修正 README 裡兩處不再準確的說法:隱私敘述(新增的量測探針會記錄 client 種類與協定版本,
不含查詢內容,統計完移除)、以及 ETF「規模多大」(實際上只有市值粗估,不是基金規模)。 - 首份 ADR。
品質
- 138 個測試(協定邊界 53 + 純轉換 72 + 目錄 13),全部離線,不依賴證交所
- 一輪 security audit(8 條候選、2 條駁回、6 條降為 hardening note、0 條確認 finding)
- 一輪多代理 code review,找出的 10 條缺陷全數修正
agents相依釘死在0.20.1——它決定協定 lane 策略,不該被例行安裝換掉
連線
https://twse-mcp.taux.io/mcp
Streamable HTTP,不需認證、不需付費。設定方式見 README。