Keelung Accessible Map MCP Server

路見不平 · Road Tag

路見不平，一起標註。

台灣騎樓與人行道通行回報地圖，支援 22 縣市、368 個行政區。

正式模式使用既有 Supabase，公開顯示民眾回報、位置與照片，正式回報開放台灣 22 個縣市與 368 個行政區。Demo 僅供隔離測試，資料不會送入正式系統。平台不是政府通報系統，也不保證路線安全。

用自己的 AI 助理查詢

支援自訂遠端 Streamable HTTP MCP 的 AI 助理，可加入 https://roadtag.org/api/mcp-public，匿名唯讀查詢公開道路障礙回報。提供座標解析、附近回報、指定案件詳情；地址／地標文字搜尋暫停，不支援公開建案、修改或照片上傳。民眾回報不是道路安全認證，沒有回報不代表安全。

官網連接入口 · MCP 接入教學 · 技術說明與查詢範例 · Official MCP Registry：org.roadtag/road-tag。2026-10-15 已登錄 1.0.0；登錄不等於各 AI 平台自動收錄。

Demo 與原始碼

唯一正式網址：roadtag.org。唯一發布流程：本機修改與驗收 → 你確認 OK → 推送 GitHub main → Vercel 自動部署 Production → 核對正式網址。ChatGPT Sites 已退出正式發布流程，保留為僅擁有者可存取的歷史封存；不合併、不同步、不再發布。程式與 Supabase migration 由同一 repo 版本管理，線上資料與照片留在 Supabase。細節見單一發布與維護流程。

功能

• / 是路見不平首頁；/map 是通行地圖與回報程式。兩者由同一個 Vite build 從本 repo 產生。
• 真實可操作底圖（無 key 時 Leaflet／OpenStreetMap）；正式站只顯示真實回報。
• 地圖標記、案件列表、狀態／行政區／通行程度篩選與既有回報搜尋。
• 三步回報：選位置、照片與問題、確認送出。
• GPS 失敗可手動選點或填座標；相近 30m 的同類未改善案件提醒。
• 原檔 10 MiB、1920px 壓縮；新上傳 WebP／1 MiB，上傳預約、配額與逾期清理。
• 獨立輪椅通行程度、民眾補充與照片歷史。
• /admin 展示管理狀態與改善前後；正式管理由資料庫 RLS 控制。
• Supabase adapter、城市 schema、server-side 驗證與原子管理紀錄。
• 手機版、鍵盤焦點、原生 dialog、文字＋圖示狀態、reduced motion。
• 長期可重開的「如何使用」與常見問題、案件分享連結、Beta 回饋與資料申請聯絡方式。

本機啟動

需要 Node.js 24 與 npm。

npm ci
npm run dev

開啟終端顯示的 localhost 網址預覽首頁；通行地圖在 /map，預設 Demo 可直接使用。

npm run lint
npm test
npm run build
npm run preview

Agent 工作規則

• 專案記憶：已知坑與標準流程
• 專案短備忘：固定決策與文件入口
• 專用 skill：.agents/skills/road-recall-site/SKILL.md

文件

• 開源評估與授權決策
• 架構、資料模型與全台擴充
• Supabase／Google Maps／Vercel 設定
• 環境變數範例
• Technical SEO 架構與路由政策
• SEO 基線、驗收與網域遷移 · SEO QA · 網域遷移清單 · SEO 變更紀錄
• 資料庫 migration 與安全規則
• 安全與 PostGIS 下一版準備
• 實際驗證結果與尚未完成項目
• Code Review：Beta 準備度
• UX Review：Beta 使用流程
• Accessibility Review：鍵盤、觸控與語意
• Beta 驗收狀態
• 封閉 Beta 使用者測試清單
• 參考專案模式與取捨

Roadmap

v0.2：封閉 Beta 回饋、CAPTCHA／跨帳號濫用防護與營運政策細化、Places／反向地理編碼、官方施工 layer 授權查核。

v0.3：PostGIS 附近案件與 viewport 查詢、縮圖、moderation、資料匯出。城市切換及案件游標分頁已實作。

v1：多城市營運與權責分工。無障礙路線導航需獨立資料品質與安全評估，不由回報點自動推論。

貢獻

先開 issue 說明問題、預期結果、手機／桌面重現步驟。PR 附驗證結果；不要提交真實通報照片、個人資料、.env 或秘密金鑰。資料庫變更使用新的 migration，保持向後相容。

License

MIT，見 LICENSE。第三方套件各自保留授權；地圖資料 © OpenStreetMap contributors（ODbL）。本專案未複製 AGPL 來源程式。