feat(mcp): add MCP Server Integration — Property Search, Analytics, Valuation

Implement 3 MCP servers in libs/mcp-servers/ using @modelcontextprotocol/sdk:

- Property Search: NL search via Typesense, property comparison, detail lookup
- Market Analytics: market reports, price trends, district comparison
- Valuation: AVM integration with Python AI service, feature extraction, batch valuation

Includes NestJS integration module with SSE transport for in-process hosting.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
Ho Ngoc Hai
2026-04-08 03:22:27 +07:00
parent efa49e225e
commit cb00b12d7b
17 changed files with 1077 additions and 41 deletions

View File

@@ -2,7 +2,7 @@
**Last Updated:** 2026-04-08
**Project:** Goodgo Platform AI
**Status:** Phase 0 Complete — Phase 1 ~80% — Phase 2 ~60%
**Status:** Phase 0-2 Complete — Phase 3 Not Started
---
@@ -19,53 +19,44 @@
## Phase 1: Core Auth & Listings (P1)
| Issue | Title | Priority | Status | Commit |
| -------------------------------- | ------------------------------------------------- | -------- | ----------- | ------ |
| [TEC-1421](/TEC/issues/TEC-1421) | Auth Module Backend (Register, Login, JWT, OAuth) | Critical | done | 391c040 |
| [TEC-1422](/TEC/issues/TEC-1422) | Auth Frontend (Login/Register + OAuth) | High | todo | — |
| [TEC-1423](/TEC/issues/TEC-1423) | Listings Module Backend (CRUD, Media, Moderation) | High | done | 8a33aae |
| [TEC-1424](/TEC/issues/TEC-1424) | Search Module Backend (Typesense + Geo) | High | done | 6741592 |
| [TEC-1425](/TEC/issues/TEC-1425) | Security Hardening (Rate Limiting, CORS, Helmet) | High | done | f3081d9 |
| [TEC-1426](/TEC/issues/TEC-1426) | Error Handling & Logging Strategy | High | done | c981bff |
| [TEC-1427](/TEC/issues/TEC-1427) | Listings Frontend (Create/Edit + Detail) | High | done | 207a201 |
| [TEC-1428](/TEC/issues/TEC-1428) | Search + Landing Page Frontend | High | done | 5e44456 |
| Issue | Title | Priority | Status | Commit |
| -------------------------------- | ------------------------------------------------- | -------- | ------ | ------ |
| [TEC-1421](/TEC/issues/TEC-1421) | Auth Module Backend (Register, Login, JWT, OAuth) | Critical | done | 391c040 |
| [TEC-1422](/TEC/issues/TEC-1422) | Auth Frontend (Login/Register + OAuth) | High | done | bfdd2f7 |
| [TEC-1423](/TEC/issues/TEC-1423) | Listings Module Backend (CRUD, Media, Moderation) | High | done | 8a33aae |
| [TEC-1424](/TEC/issues/TEC-1424) | Search Module Backend (Typesense + Geo) | High | done | 6741592 |
| [TEC-1425](/TEC/issues/TEC-1425) | Security Hardening (Rate Limiting, CORS, Helmet) | High | done | f3081d9 |
| [TEC-1426](/TEC/issues/TEC-1426) | Error Handling & Logging Strategy | High | done | c981bff |
| [TEC-1427](/TEC/issues/TEC-1427) | Listings Frontend (Create/Edit + Detail) | High | done | 207a201 |
| [TEC-1428](/TEC/issues/TEC-1428) | Search + Landing Page Frontend | High | done | 5e44456 |
## Phase 2: Monetization & Operations (P2)
| Issue | Title | Priority | Status | Commit |
| -------------------------------- | ----------------------------------------------- | -------- | ----------- | ------ |
| [TEC-1429](/TEC/issues/TEC-1429) | Payments Module (VNPay + MoMo + ZaloPay) | Medium | done | ad77139 |
| [TEC-1430](/TEC/issues/TEC-1430) | Subscriptions Module (Plans, Quotas, Billing) | Medium | done | 9b581b7 |
| [TEC-1431](/TEC/issues/TEC-1431) | Notifications Module (Email, SMS, Zalo OA, FCM) | Medium | done | 0b29fac |
| [TEC-1432](/TEC/issues/TEC-1432) | Admin Module (Backend + Frontend) | Medium | todo | — |
| [TEC-1433](/TEC/issues/TEC-1433) | E2E Testing Setup (Playwright) | Medium | done | 9301f44 |
| Issue | Title | Priority | Status | Commit |
| -------------------------------- | ----------------------------------------------- | -------- | ------ | ------ |
| [TEC-1429](/TEC/issues/TEC-1429) | Payments Module (VNPay + MoMo + ZaloPay) | Medium | done | ad77139 |
| [TEC-1430](/TEC/issues/TEC-1430) | Subscriptions Module (Plans, Quotas, Billing) | Medium | done | 9b581b7 |
| [TEC-1431](/TEC/issues/TEC-1431) | Notifications Module (Email, SMS, Zalo OA, FCM) | Medium | done | 0b29fac |
| [TEC-1432](/TEC/issues/TEC-1432) | Admin Module (Backend + Frontend) | Medium | done | 6123fc4 |
| [TEC-1433](/TEC/issues/TEC-1433) | E2E Testing Setup (Playwright) | Medium | done | 60a0b3c |
## Phase 3: AI & Advanced (P3) — Not yet created
## Phase 3: AI & Advanced (P3) — Not yet started
- AI/ML Services Container (Python FastAPI + XGBoost)
- Analytics Module (Market reports, AVM)
- MCP Server Integration
- Performance Monitoring (Prometheus + Grafana)
| Issue | Title | Priority | Status |
| ----- | ------------------------------------------------ | -------- | ------ |
| — | Analytics Module (Market Reports, Price Index) | High | todo |
| — | AI/ML Services Container (Python FastAPI + XGBoost) | High | todo |
| — | MCP Server Integration (Property Search, Analytics, Valuation) | Medium | todo |
| — | Performance Monitoring (Prometheus + Grafana) | Low | todo |
---
## Remaining Work for MVP
| Item | Priority | Status |
|------|----------|--------|
| Auth Frontend (Login/Register pages) | High | todo |
| Auth OAuth strategies (Google, Zalo) | High | todo |
| Admin Module (Backend + Frontend) | Medium | todo |
| SMS + Zalo OA notification services | Medium | todo |
| E2E test coverage expansion | Medium | todo |
| Docker deploy pipeline completion | Low | todo |
## Summary
| Phase | Total | Done | In Progress | Todo |
| --------- | ------ | ----- | ----------- | ---- |
| Phase 0 | 6 | 6 | 0 | 0 |
| Phase 1 | 8 | 7 | 0 | 1 |
| Phase 2 | 5 | 4 | 0 | 1 |
| Phase 3 | 4 | | | 4 |
| **Total** | **23** | **17**| **0** | **6**|
| Phase 1 | 8 | 8 | 0 | 0 |
| Phase 2 | 5 | 5 | 0 | 0 |
| Phase 3 | 4 | 0 | 0 | 4 |
| **Total** | **23** | **19**| **0** | **4**|