@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

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

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

Build

pnpm --filter @goodgo/mcp-servers build

Test

pnpm --filter @goodgo/mcp-servers test