地质数据查询服务

提供台湾地区土壤液化、活动断层、地质敏感区、山崩警戒等地质与灾害数据的查询服务。

  • by MackinHung
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 MackinHung/mcp-taiwan-geology

使用说明

MCP Taiwan Geology

台灣地質與災害資料 MCP Server - 提供土壤液化、活動斷層、地質敏感區、山崩警戒等資料

工具清單

工具名稱 說明
query_liquefaction_potential 查詢指定座標的土壤液化潛勢等級(高/中/低)
get_active_faults_nearby 查詢座標附近活動斷層(名稱、距離、類型)
query_sensitive_areas 查詢座標附近地質敏感區(斷層/山崩/地滑)
get_landslide_alerts 取得目前大規模崩塌警戒(紅/黃色)
get_geological_info 取得指定座標地質圖資訊(地層/年代/岩性)

安全徽章

  • 資料敏感度: public(公開資料)
  • 權限: readonly(僅讀取)
  • 開源: 是
  • 外部資料源:
    • https://ls.ardswc.gov.tw
    • https://geomap.gsmma.gov.tw
    • https://data.gov.tw
    • https://www.gsmma.gov.tw

安裝

npm install

使用方式

Cloudflare Workers 部署

npx wrangler deploy

部署後會得到一個 Worker URL,可透過 JSON-RPC 2.0 協定呼叫。

MCP 協定流程

  1. initialize - 初始化連線,取得 server 資訊
  2. tools/list - 列出所有可用工具
  3. tools/call - 呼叫特定工具

範例請求

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "query_liquefaction_potential",
    "arguments": {
      "latitude": 25.033,
      "longitude": 121.565
    }
  }
}

Claude Desktop 整合

在 claude_desktop_config.json 中新增:

{
  "mcpServers": {
    "taiwan-geology": {
      "url": "https://your-worker.workers.dev"
    }
  }
}

技術棧

  • 框架: Hono + Cloudflare Workers
  • 語言: TypeScript (strict mode)
  • 測試: Vitest (77 tests, 100% coverage)
  • 協定: MCP (Model Context Protocol) 2024-11-05

開發

# 開發模式
npm run dev

# 執行測試
npm test

# 測試覆蓋率
npm run test:coverage

# TypeScript 檢查
npx tsc --noEmit

資料來源

  • 經濟部地質調查及礦業管理中心
  • 農業部農村發展及水土保持署
  • 政府資料開放平台

License

MIT