@iamqh/vn-traffic-fine
v1.0.5
Published
Tra cuu phat nguoi - Vietnamese traffic violation lookup (MCP server + CLI)
Readme
VN-traffic-fine
Tra cuu phat nguoi - Vietnamese traffic violation lookup (MCP server + CLI).
Cai dat
npm install @iamqh/vn-traffic-fineHoac dung npx truc tiep (khong can cai dat):
npx @iamqh/vn-traffic-fine 51F12345 # CLI
npx --package @iamqh/vn-traffic-fine vn-traffic-mcp # MCP serverYeu cau: Node.js 22+
MCP Server
Dang ky voi Claude Code:
{
"mcpServers": {
"vn-traffic": {
"command": "npx",
"args": ["--package", "@iamqh/vn-traffic-fine", "vn-traffic-mcp"]
}
}
}CLI
npx @iamqh/vn-traffic-fine 51F12345 # O to
npx @iamqh/vn-traffic-fine 30H47465 2 # Xe may
npx @iamqh/vn-traffic-fine 51F12345 1 -v # VerboseLoai phuong tien: 1 = O to, 2 = Xe may, 3 = Xe may dien
REST API
npm run dev # development mode (watch)
npm run start # production modeGET /api?licensePlate=<bien_so>&type=<loai>
POST /api/lookup body: {"plate": "...", "type": "1"}
GET /health
curl "http://localhost:3000/api?licensePlate=30H47465&type=2"Cau truc
src/
engines/ # API engines (checkphatnguoi, zm.io, phatnguoi)
phatnguoi.ts # Orchestrator + types
mcp/server.ts # MCP server
bin/cli.ts # CLI entry
server.ts # Express REST APIKiem tra TypeScript
npm run typeCheck