:ru: [English below](#english)

# MCP-Эстиматор

Агент-интерфейс для расчёта смет на видеонаблюдение, структурированные кабельные системы (СКС) и слаботочные системы.

Создан для [OpenAI WebMCP Challenge](https://openai.com/webmcp-challenge/).

## Быстрый старт

```bash
uv venv --python 3.12
source .venv/bin/activate
uv pip install -e ".[dev]"
python -m src.app
```

Откройте `http://localhost:8000` — веб-форма для расчёта сметы.

MCP endpoint: `http://localhost:8000/mcp` (Streamable HTTP).

Optional photo analysis dependencies:

```bash
uv pip install -e ".[vision]"
```

## Инструменты MCP

- `estimate_project` — расчёт сметы по параметрам объекта
- `get_bom` — ведомость материалов
- `generate_proposal` — коммерческое предложение
- `suggest_camera_placement` — рекомендации по расстановке камер

PDF export: `GET /api/estimate/pdf`.

## Стек

- Python 3.12
- `mcp` SDK (Streamable HTTP)
- FastAPI + Jinja2
- Ultralytics YOLOv8 (optional `vision` extra)
- fpdf2

## Лицензия

MIT

---

<a name="english"></a>

# MCP-Estimator

Agent interface for estimating video surveillance, structured cabling and low-current systems projects.

Built for the [OpenAI WebMCP Challenge](https://openai.com/webmcp-challenge/).

## Quick start

```bash
uv venv --python 3.12
source .venv/bin/activate
uv pip install -e ".[dev]"
python -m src.app
```

Open `http://localhost:8000` for the web estimator.

MCP endpoint: `http://localhost:8000/mcp` (Streamable HTTP).

Optional photo analysis dependencies:

```bash
uv pip install -e ".[vision]"
```

## MCP tools

- `estimate_project` — calculate estimate from project parameters
- `get_bom` — bill of materials
- `generate_proposal` — commercial proposal text
- `suggest_camera_placement` — camera placement recommendations

PDF export: `GET /api/estimate/pdf`.

## License

MIT