# @goodgo/mcp-servers

Thư viện tool server MCP (Model Context Protocol) cho GoodGo Platform. Cung cấp các công cụ có cấu trúc để trợ lý AI có thể truy vấn dữ liệu bất động sản, chạy phân tích và thực hiện định giá.

## Tool Servers

| Server | Đường dẫn | Mô tả |
|--------|------|-------------|
| **Property Search** | `property-search/` | Tìm kiếm theo vị trí địa lý, full-text search, lọc theo loại/giá/diện tích |
| **Market Analytics** | `market-analytics/` | Xu hướng giá, heatmap, so sánh giữa các quận |
| **Valuation** | `valuation/` | Yêu cầu định giá bất động sản qua AVM |

## Tech Stack

- **TypeScript** 6+
- **@modelcontextprotocol/sdk** 1.12 (triển khai giao thức MCP)
- **Zod** 3.24 (kiểm tra schema)
- **NestJS** module tích hợp (peer dependency tuỳ chọn)

## Cấu trúc dự án

```
libs/mcp-servers/
├── src/
│   ├── index.ts            # Public API exports
│   ├── property-search/    # Property search tool server
│   ├── market-analytics/   # Market analytics tool server
│   ├── valuation/          # AVM valuation tool server
│   ├── nestjs/             # NestJS module integration
│   ├── shared/             # Shared types and utilities
│   └── __tests__/          # Test suite
├── package.json
└── tsconfig.json
```

## Cách dùng

```typescript
import { PropertySearchServer, MarketAnalyticsServer } from '@goodgo/mcp-servers';
```

Các endpoint MCP được expose qua module `apps/api/src/modules/mcp/` của API.

## Build

```bash
pnpm --filter @goodgo/mcp-servers build
```

## Test

```bash
pnpm --filter @goodgo/mcp-servers test
```
