# Zangia — zangia.mn-ийн ажлын байр хайх MCP сервер

[![npm](https://img.shields.io/npm/v/zangia?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/zangia)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](LICENSE)
[![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A518-brightgreen?style=for-the-badge&logo=node.js)](https://nodejs.org)
[![MCP](https://img.shields.io/badge/MCP-stdio-purple?style=for-the-badge&logo=anthropic)](https://modelcontextprotocol.io)

[zangia.mn](https://www.zangia.mn) дээрх **бодит ажлын байрыг** шууд хайх, CV/анкетыг ажлын байртай тааруулах (ATS), цалингийн жишиг үзүүлэлт гаргах — бүгдийг **Model Context Protocol (MCP)** серверээр.

**Багц:** [`zangia`](https://www.npmjs.com/package/zangia) · **CLI:** `zangia` · **Node.js ≥ 18** (`npx`-д Bun шаардлагагүй)

> Доорх зургууд нь орон нутгийн аппыг `bun run screenshots`-аар авсан **бодит Playwright** агшин зургууд — AI-аар зурсан mockup биш.

![Landing — суулгалт + клиент тохиргоо](https://raw.githubusercontent.com/enkhbold470/zangia-mcp-ai/main/docs/images/zangia_ai_dashboard.png)

---

## Хурдан эхлэх (нэг команд)

```bash
npx -y zangia
```

Ижил бинар өөр аргаар:

```bash
bunx zangia
pnpm dlx zangia
yarn dlx zangia
```

---

## Код бичих агент болон CLI дээр суулгах

Доорх бүх орчин ижил stdio серверийг асаана: `npx -y zangia`.

### Claude Code

```bash
claude mcp add zangia -- npx -y zangia
claude mcp list
```

Төслийн хүрээнд (багийн хувьд `.mcp.json` commit хийнэ):

```bash
claude mcp add zangia -s project -- npx -y zangia
```

### OpenAI Codex (CLI / IDE / desktop)

```bash
codex mcp add zangia -- npx -y zangia
codex mcp list
```

Эсвэл `~/.codex/config.toml` засна:

```toml
[mcp_servers.zangia]
command = "npx"
args = ["-y", "zangia"]
```

### Cursor

**Settings → MCP → Add new MCP server**, эсвэл `.cursor/mcp.json` үүсгэнэ:

```json
{
  "mcpServers": {
    "zangia": {
      "command": "npx",
      "args": ["-y", "zangia"]
    }
  }
}
```

Репогийн үндсэн хавтас дахь `.mcp.json` (Claude Code project scope-той нийцнэ):

```json
{
  "mcpServers": {
    "zangia": {
      "command": "npx",
      "args": ["-y", "zangia"]
    }
  }
}
```

### Windsurf

Windsurf-ийн MCP тохиргоонд (Cursor-тэй ижил JSON), эсвэл `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "zangia": {
      "command": "npx",
      "args": ["-y", "zangia"]
    }
  }
}
```

### Claude Desktop

Тохиргооны файлаа зассаны дараа Claude Desktop-оо дахин асаана:

| OS | Зам |
| :--- | :--- |
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
| Linux | `~/.config/Claude/claude_desktop_config.json` |

```json
{
  "mcpServers": {
    "zangia": {
      "command": "npx",
      "args": ["-y", "zangia"]
    }
  }
}
```

### VS Code (GitHub Copilot Chat MCP)

`.vscode/mcp.json` эсвэл хэрэглэгчийн MCP тохиргоонд:

```json
{
  "servers": {
    "zangia": {
      "command": "npx",
      "args": ["-y", "zangia"]
    }
  }
}
```

(Зарим VS Code хувилбар `"mcpServers"` түлхүүр ашиглана — өөрийн редакторын schema-тай тааруулна уу.)

### Continue.dev

`~/.continue/config.json` (эсвэл YAML хувилбар):

```json
{
  "mcpServers": [
    {
      "name": "zangia",
      "command": "npx",
      "args": ["-y", "zangia"]
    }
  ]
}
```

### Cline / Roo Code (VS Code)

MCP тохиргооны JSON (Cline / Roo MCP самбар):

```json
{
  "mcpServers": {
    "zangia": {
      "command": "npx",
      "args": ["-y", "zangia"],
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

### Gemini CLI

```bash
gemini mcp add zangia npx -y zangia
```

Gemini CLI JSON тохиргоо ашиглавал Cursor-тэй ижил `command` / `args` ашиглана.

### Amp болон бусад stdio MCP host

Локал stdio процесс асааж чаддаг аль ч клиент:

| Талбар | Утга |
| :--- | :--- |
| Command | `npx` |
| Args | `-y` `zangia` |
| Transport | stdio |

### Smithery

Энэ репо дахь `smithery.yaml` дараахыг эхлүүлнэ:

```text
npx -y zangia
```

### Локал clone (хөгжүүлэлт)

```json
{
  "mcpServers": {
    "zangia": {
      "command": "bun",
      "args": ["run", "bin/mcp-stdio.ts"]
    }
  }
}
```

---

## Зөв ажиллаж байгаа эсэхийг шалгах

Суулгасны дараа агентаас асууна:

```text
zangia MCP-ийн search_jobs багажийг ашиглаад Sukhbaatar дүүргийн ажлын байруудыг хайж, бодит URL-уудыг жагсаа.
```

Эсвэл stdio-г өөрөө туршина:

```bash
printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | npx -y zangia
```

Дараах багажууд харагдана: `search_jobs`, `get_job_details`, `match_candidate_cv`, `filter_by_salary`, `get_salary_benchmarks`, `post_job`.

---

## Амьд аппын агшин зураг (Playwright)

Бодит UI-аас `bun run screenshots`-аар авсан (Vite + API ажиллаж байх ёстой).

**Prompt + амьд sandbox** (zangia.mn-ийн бодит холбоос буцаасан):

![Prompt болон амьд sandbox](https://raw.githubusercontent.com/enkhbold470/zangia-mcp-ai/main/docs/images/ats_resume_matcher.png)

**MCP Tool Inspector** (дуудлагын тоолуур / stdio+SSE):

![MCP Live Inspector](https://raw.githubusercontent.com/enkhbold470/zangia-mcp-ai/main/docs/images/mcp_inspector_widget.png)

---

## MCP багажууд

| Багаж | Параметр | Тайлбар |
| :--- | :--- | :--- |
| `search_jobs` | `query?`, `category?`, `district?`, `isRemote?`, `minSalary?`, `limit?` | zangia.mn дээрх амьд ажлын байр + локал өгөгдөл |
| `get_job_details` | `jobId` | Локал ID эсвэл амьд код (`zangia-live-<code>` / зөвхөн код) |
| `match_candidate_cv` | `cvText`, `targetJobId?`, `minMatchScore?` | ATS тааралт + 5 тэнхлэгт ур чадварын зөрүү |
| `filter_by_salary` | `minSalary?`, `maxSalary?`, `currency?` | Цалингаар шүүх (зөвхөн мэдэгдэж буй цалинтай бичлэг) |
| `get_salary_benchmarks` | `category?` | Салбарын мин / макс / дундаж |
| `post_job` | title, company, category, district, цалин, skills, description | Процессын санах ойд түр ажлын байр нэмэх |

Амьд үр дүн бүрд бодит холбоос байна: `https://www.zangia.mn/job/<code>`.

### Өгөгдлийн үнэн зөв байдал (амьд crawl)

Нүүр хуудасны жагсаалтын crawl зөвхөн **гарчиг + код**-ыг өгнө:

- `district` — гарчгийн түлхүүр үгнээс таамаглана; олдохгүй бол `Unknown` (**Сүхбаатар гэж зориуд бүү зохио**)
- `salaryKnown: false` — бодит цалинг `url` дээрээс үзнэ
- Улаанбаатарын төв ≈ гарчиг дахь газрын тэмдэг (Нарны зам, Зүүн дөрвөн зам, Сүхбаатар бизнес) — **Сүхбаатар аймаг биш**
- Cursor-ийн **WebFetch** нь бүрэн HTML хуудас уншихад сонголттой; энэ MCP серверийн нэг хэсэг **биш**

### Resource болон prompt

| Төрөл | Нэр |
| :--- | :--- |
| Resource | `job://listings/active`, `job://{id}` |
| Prompt | `tailor-resume-for-job` (`jobId`, `candidateResume`) |

---

## Локал хөгжүүлэлт

Вэб апп, API, тестэд [Bun](https://bun.sh) хэрэгтэй.

```bash
git clone https://github.com/enkhbold470/zangia-mcp-ai.git
cd zangia-mcp-ai
bun install

bun run mcp:stdio     # MCP — stdio
bun run mcp:sse       # MCP — SSE
bun run server        # Hono API + inspector SSE :4000
bun run dev           # Vite landing :3000 (/api → :4000 proxy)
bun run test          # E2E тест
bun run build         # Вэб dist + Node MCP бинар
bun run build:mcp     # Зөвхөн MCP бинар
bun run screenshots   # Playwright PNG → docs/images/
bun run publish:npm   # .env дахь NPM_TOKEN (+ passkey) ашиглан нийтлэх
```

Нийтлэгдсэн tarball: `bin/mcp-stdio.js`, `README.md`, `LICENSE`, `server.json`, `smithery.yaml`.

---

## Хувь нэмэр оруулах

Нээлттэй эх төсөл. Алдаа мэдээлэх, сайжруулалт санал болгох, pull request илгээх зааврыг [CONTRIBUTING.md](CONTRIBUTING.md)-аас үзнэ үү. Аюулгүй байдлын мэдэгдэл: [SECURITY.md](SECURITY.md).

---

## Лиценз

MIT — дэлгэрэнгүйг [LICENSE](LICENSE) файлаас үзнэ үү.

Зохиогчийн эрх © 2026 [enkhbold470](https://github.com/enkhbold470).