docs: dịch 22 file Markdown còn lại sang tiếng Việt có dấu (TEC-2881)
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>
This commit is contained in:
Ho Ngoc Hai
2026-04-19 03:26:14 +07:00
parent 11f2bf26e6
commit d8b409a9ab
22 changed files with 3697 additions and 3703 deletions

View File

@@ -1,23 +1,23 @@
# @goodgo/mcp-servers
MCP (Model Context Protocol) tool server library for the GoodGo Platform. Provides structured tools that AI assistants can use to query property data, run analytics, and perform valuations.
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 | Path | Description |
| Server | Đường dẫn | Mô tả |
|--------|------|-------------|
| **Property Search** | `property-search/` | Geo search, full-text search, filter by type/price/area |
| **Market Analytics** | `market-analytics/` | Price trends, heatmaps, district comparisons |
| **Valuation** | `valuation/` | AVM property valuation requests |
| **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 (MCP protocol implementation)
- **Zod** 3.24 (schema validation)
- **NestJS** integration module (optional peer dependency)
- **@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)
## Project Structure
## Cấu trúc dự án
```
libs/mcp-servers/
@@ -33,21 +33,21 @@ libs/mcp-servers/
└── tsconfig.json
```
## Usage
## Cách dùng
```typescript
import { PropertySearchServer, MarketAnalyticsServer } from '@goodgo/mcp-servers';
```
The MCP endpoints are exposed via the API's `apps/api/src/modules/mcp/` module.
Các endpoint MCP được expose qua module `apps/api/src/modules/mcp/` của API.
## Building
## Build
```bash
pnpm --filter @goodgo/mcp-servers build
```
## Testing
## Test
```bash
pnpm --filter @goodgo/mcp-servers test