d8b409a9ab
Some checks failed
CI / Lint → Typecheck → Test → Build (22) (push) Failing after 18s
CI / E2E Tests (push) Has been skipped
CodeQL Analysis / CodeQL (javascript-typescript) (push) Failing after 2m15s
Deploy / Build API Image (push) Failing after 28s
Deploy / Build Web Image (push) Failing after 16s
Deploy / Build AI Services Image (push) Failing after 17s
E2E Tests / Playwright E2E (push) Failing after 31s
Security Scanning / Dependency Audit (pnpm) (push) Failing after 3s
Security Scanning / Trivy Scan — API Image (push) Failing after 1m46s
Security Scanning / Trivy Scan — Web Image (push) Failing after 1m7s
Security Scanning / Trivy Scan — AI Services Image (push) Failing after 53s
Security Scanning / Trivy Filesystem Scan (push) Failing after 35s
Deploy / Deploy to Staging (push) Has been skipped
Deploy / Smoke Test Staging (push) Has been skipped
Deploy / Deploy to Production (push) Has been skipped
Deploy / Smoke Test Production (push) Has been skipped
Security Scanning / Security Gate (push) Failing after 0s
Deploy / Rollback Staging (push) Has been skipped
Deploy / Rollback Production (push) Has been skipped
Hoàn tất đợt cuối của nhiệm vụ chuyển toàn bộ tài liệu sang tiếng Việt. Đã dịch 22 file `.md` còn sót (~9.7k dòng) — gồm RUNBOOK, audits, docs/architecture, docs/load-testing, libs READMEs và các quick references. Giữ nguyên code blocks, đường dẫn, identifier kỹ thuật, URL và biến môi trường. Co-Authored-By: Paperclip <noreply@paperclip.ing>
@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