591 Real Estate 591 房地產資料

• 4 ready-to-use tools for sale search, sale detail, rent search, rent detail
• MCP server (stdio) — plug into Claude Code and start asking questions immediately
• Natural-language parameter mapping — Chinese region/section names, human-readable filters (e.g. 電梯大樓, 3房, 5_10)
• Minimal dependencies — fastmcp + requests

Install

pip install mcp-591

Or use uvx (no install needed):

uvx mcp-591

Use with Claude Code

Add the server via the Claude CLI:

claude mcp add --transport stdio 591 -- uvx mcp-591

If you clone the repo locally, the included .mcp.json is auto-detected by Claude Code:

{
  "mcpServers": {
    "591": {
      "command": "uv",
      "args": ["run", "mcp-591"],
      "cwd": "${PWD}"
    }
  }
}

Use with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "591": {
      "command": "uvx",
      "args": ["mcp-591"]
    }
  }
}

search_sale — Search for sale listings

get_sale_detail — Fetch full sale listing details

Returns: floor area breakdown (main area / common-area ratio), floor, building age, nearby transit, parking, fitment, mortgage estimate, contact info, and description.

search_rent — Search for rental listings

get_rent_detail — Fetch full rental listing details

Returns: price, deposit, floor area, floor, building type, layout, address with lat/lng, lease period, move-in date, pet/cooking/gender policies, facilities, contact info, and description.

Setup from Source

Requires Python 3.14+ and uv.

git clone https://github.com/asgard-ai-platform/mcp-591.git
cd mcp-591
uv sync --dev

Run the client directly (debugging)

# Search 桃園市中壢區
uv run python -m mcp_591.client 桃園市 中壢區

# With filters: shape pattern toilet area age
uv run python -m mcp_591.client 桃園市 中壢區 電梯大樓 3房 2衛 30_40 _5

Argument order: <county> [district] [shape,...] [pattern,...] [toilet,...] [area] [age]. Pass an empty string "" to skip an intermediate argument.

Run Tests

# Unit tests (no network, uses fixtures)
uv run pytest

# Integration tests (hits the real 591 API)
uv run pytest -m integration

Test layout

tests/
├── fixtures/
│   ├── search_sale.json   # Captured sale search response
│   ├── sale_detail.json   # Captured sale detail response
│   ├── search_rent.json   # Captured rent search response
│   └── rent_detail.json   # Captured rent detail response
├── test_server.py         # Unit tests: filtering and tool logic
└── test_integration.py    # Integration tests (skipped by default)

To refresh fixtures (requires network):

uv run python -c "
import json
from mcp_591.client import Client591
c = Client591()
json.dump(c.search_sale(region_id=6, section_ids=[67], kind=9, page_size=5),
          open('tests/fixtures/search_sale.json', 'w'), ensure_ascii=False, indent=2)
json.dump(c.get_sale_detail(19708683),
          open('tests/fixtures/sale_detail.json', 'w'), ensure_ascii=False, indent=2)
json.dump(c.search_rent(region_id=6, section_ids=[67], kind=1),
          open('tests/fixtures/search_rent.json', 'w'), ensure_ascii=False, indent=2)
json.dump(c.get_rent_detail(21103645),
          open('tests/fixtures/rent_detail.json', 'w'), ensure_ascii=False, indent=2)
"

Contributions are welcome. Please open an issue or submit a pull request.

MIT — see LICENSE.

You: 幫我搜尋青埔周邊 10 年內的大樓，總價控制在 1200 萬左右

Claude calls search_sale with the inferred parameters:

{
  "region": "桃園市",
  "section": "中壢區",
  "shape": "電梯大樓",
  "age": "5_10",
  "price_str": "1000_1400",
  "keywords": "青埔"
}

Claude: 青埔周邊 1,0001,400 萬、10 年內電梯大樓，共找到 5年內 135 筆、510年 146 筆，以下整理 CP 值較高的物件：...