# Mcp Taiwan Realestate

> MCP Server: Taiwan Real Estate Actual Price Registration (不動產實價登錄)

- **Type:** MCP server
- **Install:** `agentstack add mcp-mackinhung-mcp-taiwan-realestate`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [MackinHung](https://agentstack.voostack.com/s/mackinhung)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [MackinHung](https://github.com/MackinHung)
- **Source:** https://github.com/MackinHung/mcp-taiwan-realestate

## Install

```sh
agentstack add mcp-mackinhung-mcp-taiwan-realestate
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MCP Taiwan Realestate

> MCP Server：台灣不動產實價登錄資料查詢

提供台灣（新北市為主）不動產實價登錄資料查詢功能，支援多維度篩選與統計分析。

## 工具清單

| 工具名稱 | 說明 |
|----------|------|
| `search_transactions_by_area` | 依行政區查詢新北市不動產實價登錄成交案件 |
| `search_transactions_by_date` | 依日期範圍查詢不動產成交案件，可加價格篩選 |
| `get_area_price_statistics` | 取得區域房價統計：均價、中位數、最高最低、交易量 |
| `get_recent_transactions` | 取得最新一期不動產成交案件，依日期排序 |
| `get_price_trend` | 分析區域房價趨勢，提供月度或季度平均價與漲跌幅 |

## 安全徽章

- **資料敏感度**: public
- **權限**: readonly
- **外部 API**: data.ntpc.gov.tw
- **開源**: 是

## 安裝

```bash
npm install
```

## 使用方式

### Cloudflare Workers 部署

```bash
npx wrangler deploy
```

### MCP 協定

標準 MCP 協定流程：

1. **initialize** → 取得 server 資訊與能力宣告
2. **tools/list** → 列出所有可用工具
3. **tools/call** → 呼叫指定工具

### 工具參數範例

#### search_transactions_by_area
```json
{
  "district": "中和區",
  "limit": 20
}
```

#### search_transactions_by_date
```json
{
  "start_date": "202501",
  "end_date": "202503",
  "city": "板橋區",
  "min_price": 5000000,
  "max_price": 15000000
}
```

#### get_area_price_statistics
```json
{
  "district": "中和區",
  "property_type": "住家"
}
```

#### get_recent_transactions
```json
{
  "district": "中和區",
  "limit": 20
}
```

#### get_price_trend
```json
{
  "district": "中和區",
  "period": "monthly",
  "months_back": 12
}
```

## 技術棧

- **框架**: Hono + Cloudflare Workers
- **語言**: TypeScript (strict mode)
- **測試**: Vitest (95 tests, 100% pass rate)
- **協定**: MCP 2024-11-05

## 開發

### 本地測試

```bash
npm test
```

### 型別檢查

```bash
npx tsc --noEmit
```

### 本地開發

```bash
npm run dev
```

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [MackinHung](https://github.com/MackinHung)
- **Source:** [MackinHung/mcp-taiwan-realestate](https://github.com/MackinHung/mcp-taiwan-realestate)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-mackinhung-mcp-taiwan-realestate
- Seller: https://agentstack.voostack.com/s/mackinhung
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.