unegui.mn-mcp: Instructions file for Claude Code

CLAUDE.md

Guidance for AI assistants working in this repository.

What this is

MCP (Model Context Protocol) server for unegui.mn — Mongolia's largest classifieds marketplace. Users search/browse listings from Claude Desktop, Cursor, or any MCP client.

• Default language: Mongolian (message + message_en in API responses)
• Author: Enkhbold Ganbold (@enkhbold470)
• License: MIT

Packages (two registries)

Registry	Package name	Role
npm (public)	unegui.mn-mcp	Thin Node CLI (bin/cli.js) — user-facing install/run
PyPI / uv	unegui-mcp	Actual Python MCP server (src/unegui_mcp/)

Keep the npm package unscoped on the default registry (https://registry.npmjs.org). Do not republish as @scope/... unless explicitly requested.

User-facing commands (canonical)

npx -y unegui.mn-mcp install   # write MCP config for Claude Desktop + Cursor
npx -y unegui.mn-mcp           # run server (stdio)

MCP client config written by install (and shown in docs):

{
  "mcpServers": {
    "unegui-mcp": {
      "command": "npx",
      "args": ["-y", "unegui.mn-mcp"]
    }
  }
}

Under the hood, bin/cli.js runs the bundled Python project with uvx --from <npm-package-root> unegui-mcp (falls back to uv run --directory). It also prepends common uv paths so Cursor/Claude's minimal PATH still finds uv/uvx.

PyPI package unegui-mcp is optional; the npm tarball ships src/ + pyproject.toml so npx works without a PyPI publish.

Layout

unegui.mn-mcp/
├── bin/cli.js                 # npm entry: install | run | --help
├── package.json               # npm name: unegui.mn-mcp
├── pyproject.toml             # Python name: unegui-mcp, script: unegui-mcp
├── src/unegui_mcp/
│   ├── server.py              # MCP tools (stdio)
│   ├── scraper.py             # HTTP (curl_cffi) + BeautifulSoup/lxml
│   ├── categories.py          # Category keys + MN/EN labels
│   ├── i18n.py                # Bilingual strings / server instructions
│   └── __init__.py
├── tests/                     # pytest (+ fixtures)
├── docs/
│   ├── mn/                    # Mongolian guides
│   ├── en/                    # English guides
│   └── CHANGELOG.md, CONTRIBUTING.md, ...
├── README.md                  # Mongolian landing (primary)
└── CLAUDE.md                  # This file