mcp-server-ozon-seller: Instructions file for Claude Code

CLAUDE.md

Разработка

CRITICAL: Все правила разработки описаны в development.md. Всегда следовать им при любых изменениях кода, тестов и документации.

Запуск из исходников

pip install -e ".[test]"

Загрузка переменных из файла

# MCP-сервер с env-файлом
mcp-server-ozon-seller --env /path/to/.env

# CLI с env-файлом
ozon-seller-cli --env /path/to/.env <command>

--env загружает переменные из файла (формат KEY=VALUE) до инициализации сервера. Без --env — стандартные переменные окружения.

Запуск тестов

ruff check src/ tests/
pytest tests/ -v

Тесты мокают Ozon API — OZON_API_KEY и OZON_CLIENT_ID не нужны.

CI

GitHub Actions: .github/workflows/test.yml, runs-on: self-hosted. Токен не требуется.

Структура

src/mcp_server_ozon_seller/
├── __init__.py     # main(), версия
├── __main__.py     # python -m entry point
├── _shared.py      # FastMCP instance, хелперы (_get_api, _to_json, _parse_json, _safe_output_path, _save_bytes)
├── server.py       # 3 MCP tools: ozon_search, ozon_execute, ozon_execute_file
├── actions.py      # Каталог 111 действий (Action dataclass, ACTIONS dict)
├── models.py       # Pydantic модели параметров (75 классов, Field(description=...))
├── ozon_api.py     # HTTP-клиент Ozon Seller API (~90 методов)
└── cli.py          # CLI-интерфейс (111 субкоманд)
docs/
├── products.md     # 21 действие
├── fbs.md          # 17 действий
├── fbo.md          # 9 действий
├── categories.md   # 4 действия
├── finance.md      # 4 действия
├── analytics.md    # 3 действия
├── warehouses.md   # 2 действия
├── returns.md      # 8 действий
├── chats.md        # 6 действий
├── promos.md       # 6 действий
├── strategies.md   # 4 действия
├── rating.md       # 3 действия
├── reports.md      # 4 действия
├── reviews.md      # 4 действия
├── questions.md    # 3 действия
├── cancellations.md# 4 действия
├── certificates.md # 6 действий
├── barcodes.md     # 2 действия
└── brands.md       # 1 действие