# Taiwan Animal Adoption MCP Server (mcp-tw-pet)

這是一個專為台灣使用者設計的 MCP Server，提供全台公立動物收容所的待認養動物資訊查詢服務。資料來源為 [政府資料開放平臺 (Agriculture Open Data)](https://data.gov.tw)。

This MCP server provides access to Taiwan's Public Animal Shelter adoption data.

## Features (功能)
- **Search Animals (`search_animals`)**: 搜尋待認養動物 (貓、狗等)。支援依縣市、性別、體型篩選。
- **List Shelters (`list_shelters`)**: 列出目前有資料的收容所名單。

## Installation

### 1. Clone & Install
```bash
git clone https://github.com/simonliu-moltbot/mcp-tw-pet.git
cd mcp-tw-pet
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```

## Configuration

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

### Dive
- **Type**: `stdio`
- **Command**: `/absolute/path/to/mcp-tw-pet/.venv/bin/python`
- **Args**: `/absolute/path/to/mcp-tw-pet/src/server.py`

## License
MIT