# LangLa Server MCP — cho agent sửa client

MCP stdio cung cấp **docs protocol server** (`CLIENT_*.md`, `SERVER_*.md`) để agent LibGDX (`LangLa_kl`) tra wire MSG mà không đoán packet.

## Tools

| Tool | Việc |
|------|------|
| `list_docs` | Liệt kê tài liệu protocol |
| `read_doc` | Đọc 1 file docs (vd. `CLIENT_STATS_LONG.md`) |
| `search_docs` | Tìm chuỗi / MSG trong toàn bộ docs |
| `get_msg` | Tra nhanh theo số MSG (vd. `62`, `-49`, `-88`) |
| `server_overview` | Tóm tắt cổng, long money/stats, thứ tự ưu tiên đọc docs |

## Cài

```bash
cd langla-mcp
npm install
```

## Cursor — `mcp.json`

```json
{
  "mcpServers": {
    "langla-server": {
      "command": "node",
      "args": ["/ABS/PATH/langla-mcp/src/index.js"],
      "env": {
        "LANGLA_DOCS_DIR": "/ABS/PATH/langla-mcp/docs"
      }
    }
  }
}
```

Hoặc trỏ `LANGLA_DOCS_DIR` thẳng vào `langla-server/docs` để luôn bản mới nhất.

## Sync docs từ server

```bash
# từ máy có clone langla-server
cp ../langla-server/docs/CLIENT_*.md docs/
cp ../langla-server/docs/SERVER_*.md docs/
cp ../langla-server/docs/AUDIT_*.md docs/
```

## Không làm

- Không đổi cổng 2907/2908, MySQL, thứ tự field packet.
- Không đoán `read*`/`write*` — luôn `read_doc` / `get_msg` trước.