# 🐼 台北動物園導覽 (mcp-tw-zoo)

這是一個基於 Model Context Protocol (MCP) 開發的伺服器，提供台北市立動物園的動物資訊查詢服務。
資料來源為 [台北市政府資料開放平台](https://data.taipei/)。

## ✨ 功能 (Features)
- **搜尋動物 (Search Animals)**: 透過關鍵字（如「熊貓」、「企鵝」）查詢動物資訊。
- **區域導覽 (Area Guide)**: 列出特定區域（如「非洲動物區」）的所有動物。
- **詳細資訊 (Animal Details)**: 獲取動物的習性、分布、棲地與照片連結。

## 🛠️ 安裝與執行 (Installation)

### 前置需求
- Python 3.10+
- `mcp` SDK
- `httpx`

### 1. 建立環境
```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```

### 2. 執行伺服器 (本機測試)
```bash
python src/server.py
```
*(伺服器將等待 stdio 輸入，不會有任何輸出，這是正常的)*

## 🔌 客戶端配置 (Client Configuration)

### 🛠️ Dive Configuration
- **Type**: `stdio`
- **Command**: `/absolute/path/to/project/.venv/bin/python`
- **Args**: `/absolute/path/to/project/src/server.py`

*(請將 `/absolute/path/to/project/` 替換為您的實際路徑)*

### Claude Desktop
```json
{
  "mcpServers": {
    "tw-zoo": {
      "command": "/absolute/path/to/project/.venv/bin/python",
      "args": [
        "/absolute/path/to/project/src/server.py"
      ]
    }
  }
}
```

## 📊 資料來源
- [臺北市立動物園_動物資料](https://data.taipei/dataset/detail?id=a3e2b221-75e0-45c1-8f97-75acbd43d613)

## 📝 License
MIT