Skip to content

WiianChen/HJPLUS_Taiwan_building_code_tracker_MCP

 
 

Repository files navigation

Taiwan Building Code Tracker (台灣建築法規查詢 MCP)

Version

基於 MCP 協定的台灣建築法規自動化查詢工具,整合「法規條文」與「解釋函令」,提供最即時、精確且高品質的建築法規情報(目前以《建築技術規則建築構造編》為主)。


核心特色 (Key Features)

  • 法規與函釋雙軌檢索: 同時支援「全國法規資料庫」條文查詢與「內政部國土管理署」解釋函搜尋。
  • 動態網頁自動化技術 (Playwright):
    • 採用 Headless Browser 技術繞過進階 WAF 防護與 Next.js 動態渲染,確保能即時獲取官網最新搜尋結果。
    • 智慧標頭模擬:自動處理 JavaScript Challenge 與 Cookies,提供穩定的爬取效能。
  • 條文結構化解析: 自動解析條文中的「編」、「章」、「節」與「條號」,並維持條文內容的完整性。
  • 高效本地快取機制: 法規條文內建快取功能,大幅提升查詢速度並減少網路負擔。
  • AI 整合: 作為 Model Context Protocol (MCP) 伺服器,讓 AI (如 Claude) 能直接理解、分析並引用最新的台灣建築技術規範與實務解釋。

技術架構 (Technical Architecture)

  • Runtime: Node.js (v20+)
  • Protocol: Model Context Protocol (MCP)
  • Browser Engine: Playwright (Chromium) - 用於處理動態解釋函網頁。
  • Data Source:
    1. 法規條文全國法規資料庫 (law.moj.gov.tw)
    2. 解釋函令內政部國土管理署 (www.nlma.gov.tw)
  • 功能模組:
    1. Building Scraper: 解析條文結構與本地 JSON 快取。
    2. Interpretation Scraper: 動態搜尋國土署解釋函清單。
    3. Detail Crawler: 深入抓取解釋函內文,供 AI 分析與引用。

部署與安裝 (Deployment & Setup)

1. 環境準備

  • 安裝 Node.js (v20 或以上版本)。
  • 確認已安裝 npm

2. 下載與編譯 (Build)

# 進入專案目錄
npm install
npx playwright install chromium
npm run build

3. 設定 AI 客戶端 (Configure Client)

本服務為本機運行的 MCP Server,請將其加入 AI 客戶端(以 Claude Desktop 為例)。

找到 Claude Desktop 的設定檔 claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

將以下內容加入 mcpServers 區塊(請將路徑修改為您本機的絕對路徑):

{
  "mcpServers": {
    "taiwan-building-code": {
      "command": "node",
      "args": [
        "C:/Users/[您的使用者名稱]/.../Taiwam_building_code_tracker/dist/index.js"
      ]
    }
  }
}

使用範例 (Usage Examples)

您可以對 AI 說:

  • 「搜尋建築技術規則中關於『活載重』的規定。」
  • 「幫我查一下『採光』相關的解釋令。」
  • 「基礎構造在軟弱地層有什麼特別要求?是否有相關函釋?」
  • 「重新更新法規資料 (refresh_data)。」

關於作者 (About the Author)

我們是設計、建築與製造產業的外部研發夥伴,專門協助缺乏內部技術團隊的公司導入數位工作流程、工具與 AI。

授權與聲明 (License & Disclaimer)

免責聲明 (Disclaimer)

  1. 僅供參考:本工具提供之資訊(包含法規條文與解釋函)僅供個人查詢輔助、學術研究或技術展示使用。所有資料內容均應以「全國法規資料庫」及「內政部國土管理署」官方公告為準。
  2. 無法律建議:本工具輸出之內容不構成任何形式的法律、設計或施工建議。使用者在根據本工具提供之資訊做出任何決策(如投標、設計、施工或法律救濟)前,務必自行核實資料的準確性、時效性與法律效力,或諮詢專業人士。
  3. 無責任擔保:開發者(加號設計數位工程有限公司)不對因使用本工具資料而產生的任何直接、間接、附帶或衍生性損失負責。
  4. 合法使用義務:使用者應確保使用本工具之行為符合相關法律規範。本工具模擬瀏覽器查詢行為以落實「政府資訊公開」,嚴禁將其用於任何形式的惡意爬取、拒絕服務攻擊 (DDoS) 或其他干擾政府系統正常運作之行為。

資料來源與著作權說明

  • 資料來源:全國法規資料庫、內政部國土管理署。
  • 著作權聲明:依據中華民國《著作權法》第 9 條,法律、命令、公務員於職務上製作之文書(如解釋函)不適用著作權保護,任何人均得自由利用。本工具在引用時將自動標註原始來源與網址。

授權條款

  • 本專案採用 ISC License 開源授權。
  • 版權所有 (c) 2026 加號設計數位工程有限公司 (HJPLUS.DESIGN Ltd.)。

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages