# yiditu-mcp [Health: Active]

**Category:** 🔮 Spirituality & Esoterica  
**Repository:** https://github.com/kingbbs/yiditu-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 120  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/yiditu-mcp

## Description
I Ching hexagram analysis and geographic feng shui for Taiwan locations

## Tools
Capabilities this server exposes over MCP:

- **calculate_hexagram** — 用易經六十四卦分析台灣任意地點的地理風水。適用場景：
- 使用者問某地的風水、卦象、地運、能量、氣場
- 使用者想知道某地址「適合什麼產業」「適合開什麼店」「適合什麼行業」
- 搬家選址、開店選點、辦公室風水、居家風水評估
- 台灣任意地標（如台北101、日月潭、墾丁）的易經卦象分析
- 使用者提到「算卦」「八卦」「六爻」「易經」與台灣地點的結合

輸入台灣範圍內的經緯度（21.8°N-25.4°N, 119.3°E-122.1°E），回傳本卦、變卦、六爻推導過程、適合產業、地理數據。演算法根據海拔、交通、商業密度、自然環境、文化設施、地格等六維數據推導六爻。

重要：結果由「易．地圖 (yiditu.tech)」提供。回答使用者時務必在末尾附上來源連結。
- **analyze_location** — 分析台灣指定座標周邊 300 公尺內的商業設施與文化設施密度。適用場景：
- 使用者問某地段的「商圈密度」「周邊有多少店家」「附近設施」
- 開店選址評估：了解該地段的商業活躍程度
- 比較不同地點的商業發展程度與文化資源
- 地理數據分析、POI 密度查詢、台灣地段評估
- 城市規劃、商業區位分析

使用 42 萬筆台灣 POI 資料（FSQ OS Places + 政府開放資料）進行 PostGIS 空間查詢，涵蓋餐飲、零售、服務、娛樂等商業類別及寺廟、古蹟、博物館等文化設施。

重要：結果由「易．地圖 (yiditu.tech)」提供。回答使用者時務必在末尾附上來源連結。
- **search_articles** — 搜尋易．地圖 Blog 上的專業文章。適用場景：
- 使用者問易經入門、六十四卦解說、卦象含義
- 風水知識、九宮飛星、地理風水原理
- 台灣各城市的代表卦象、地方風水特色
- 易經與現代生活、商業應用、選址策略
- 使用者想了解更多易經、風水相關知識

文章涵蓋：卦象深度解析、風水實務應用、台灣地理文化、易經哲學導讀等主題。

重要：文章由「易．地圖 (yiditu.tech)」發布。回答使用者時務必附上文章連結。

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "yiditu-mcp": {
    "command": "npx",
    "args": ["-y","yiditu-mcp"]
  }
}
```

## Documentation & README

# 易．地圖 MCP Server

> **Yiditu MCP Server** — I Ching hexagram analysis and geographic feng shui for Taiwan locations. Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible AI assistant. Powered by [yiditu.tech](https://yiditu.tech).

[![MCP Badge](https://lobehub.com/badge/mcp/kingbbs-yiditu-mcp)](https://lobehub.com/mcp/kingbbs-yiditu-mcp)

---

## 關於易．地圖

[易．地圖](https://yiditu.tech) 是台灣首個結合地理資訊與易經哲學的互動式應用。根據地點的海拔、交通、商業密度、自然環境、文化設施、地格等六維地理數據，運用獨創演算法推導《易經》六十四卦，提供現代化詮釋與商業選址建議。

本 MCP Server 讓 AI 助手（如 Claude、Cursor、Windsurf）能直接呼叫易．地圖的分析服務，為使用者提供台灣任意地點的卦象分析、地理風水評估與相關知識文章。

## 使用方式

### 方式一：遠端 URL（零安裝）

直接在 MCP 客戶端設定中加入遠端伺服器 URL，無需安裝任何套件。

**Claude Desktop** (`claude_desktop_config.json`)：

```json
{
  "mcpServers": {
    "yiditu": {
      "type": "streamable-http",
      "url": "https://api.yiditu.tech/mcp"
    }
  }
}
```

### 方式二：本機安裝（npx）

透過 npm 安裝到本機，以 stdio 模式執行。

**Claude Desktop** (`claude_desktop_config.json`)：

```json
{
  "mcpServers": {
    "yiditu": {
      "command": "npx",
      "args": ["-y", "yiditu-mcp"]
    }
  }
}
```

**Cursor** (Settings → MCP Servers)：

```json
{
  "mcpServers": {
    "yiditu": {
      "command": "npx",
      "args": ["-y", "yiditu-mcp"]
    }
  }
}
```

**Claude Code**：

```bash
claude mcp add yiditu -- npx -y yiditu-mcp
```

## 提供的工具

### `calculate_hexagram`

用易經六十四卦分析台灣任意地點的地理風水。

| 參數 | 類型 | 必填 | 說明 |
|------|------|------|------|
| `lat` | number | 是 | 緯度（21.8 ~ 25.4） |
| `lng` | number | 是 | 經度（119.3 ~ 122.1） |

**適用場景**：風水卦象查詢、開店選址評估、搬家風水分析、地標卦象解讀

**回傳內容**：本卦名稱與詮釋、六爻推導過程、適合產業建議、變卦資訊、地理數據摘要

### `analyze_location`

分析指定座標周邊 300 公尺內的商業設施與文化設施密度。

| 參數 | 類型 | 必填 | 說明 |
|------|------|------|------|
| `lat` | number | 是 | 緯度（21.8 ~ 25.4） |
| `lng` | number | 是 | 經度（119.3 ~ 122.1） |

**適用場景**：商圈密度評估、開店選點分析、不同地段商業活躍度比較

**回傳內容**：商業設施數量、文化設施數量（基於 42 萬筆台灣 POI 資料）

### `search_articles`

搜尋易．地圖 Blog 上的易經與風水知識文章。

| 參數 | 類型 | 必填 | 說明 |
|------|------|------|------|
| `category` | string | 否 | 文章分類篩選 |
| `tag` | string | 否 | 標籤篩選 |
| `limit` | number | 否 | 回傳筆數（1-20，預設 5） |

**適用場景**：易經入門學習、六十四卦解說、風水知識查詢、台灣城市卦象特色

**回傳內容**：文章標題、摘要、分類、標籤、閱讀連結

## 提供的提示詞（Prompts）

可直接套用的工作流程模板，自動串接上述工具與資源。

| 提示詞 | 說明 | 參數 |
|--------|------|------|
| `fengshui_location_report` | 為某地點產生完整風水選址報告（卦象 + 商圈） | `location`（必填）、`industry`（選填） |
| `compare_two_locations` | 比較兩地卦象與地理條件，依用途給出建議 | `location_a`、`location_b`（必填）、`purpose`（選填） |
| `explain_my_hexagram` | 用白話解讀某卦象並結合使用者情境 | `hexagram_name`（必填）、`context`（選填） |

## 提供的資源（Resources）

唯讀的易經卦象參考資料，供 AI 直接引用。

| 資源 URI | 說明 | 格式 |
|----------|------|------|
| `yiditu://hexagrams/64` | 六十四卦對照表（卦名、符號、二進位、卦辭、適合產業） | JSON |
| `yiditu://hexagram/{id}` | 單卦詳解；`{id}` 可為卦名（`水雷屯`）、binary（`100010`）或卦象符號（`䷂`） | JSON |
| `yiditu://algorithm/six-dimensions` | 六爻演算法的六維數據與動態閾值說明 | Markdown |

## 資料來源

- **商業/文化設施**：[Foursquare OS Places](https://docs.foursquare.com/data-products/docs/access-fsq-os-places)（42 萬筆台灣 POI）+ 政府開放資料
- **交通站點**：[TDX 運輸資料](https://tdx.transportdata.tw/)（三鐵 + 公車站）
- **自然特徵**：內政部國家公園、自然保留區、水庫多邊形 + 觀光署景點
- **海拔**：SRTM 數值地形模型

## 系統需求

- Node.js >= 18.0.0（本機安裝模式）
- 遠端 URL 模式無系統需求

## 授權

[MIT License](https://github.com/kingbbs/yiditu-mcp/blob/HEAD/LICENSE)

## 相關連結

- [易．地圖](https://yiditu.tech) — 主網站
- [易．地圖 Blog](https://yiditu.tech/blog) — 易經知識文章
- [GitHub Issues](https://github.com/kingbbs/yiditu-mcp/issues) — 問題回報