ozon-mcp-server 2.0.0__tar.gz

ozon_mcp_server-2.0.0/.dockerignore

@@ -0,0 +1,7 @@
+__pycache__
+*.pyc
+.env
+.git
+tests
+config
+README.md

ozon_mcp_server-2.0.0/.env.example

@@ -0,0 +1,22 @@
+# Ozon Seller API (опционально — магазины удобнее добавлять через веб-UI /shops)
+OZON_CLIENT_ID=
+OZON_API_KEY=
+
+# Ozon Performance API (реклама)
+OZON_PERF_CLIENT_ID=
+OZON_PERF_CLIENT_SECRET=
+
+# Токен авторизации MCP-эндпоинтов (/sse и /messages).
+# ОБЯЗАТЕЛЬНО задать при доступе из внешней сети!
+# Сгенерировать: openssl rand -hex 32
+# Клиент передаёт: Authorization: Bearer <токен> или ?token=<токен>
+MCP_AUTH_TOKEN=
+
+# Интервал фоновой диагностики Ozon API в минутах (0 = выключить)
+HEALTH_CHECK_INTERVAL_MIN=30
+
+# Директория данных (shops.json, stats.db, .encryption_key)
+# DATA_DIR=/data
+
+# Порт сервера (по умолчанию 8000)
+# PORT=8000

ozon_mcp_server-2.0.0/.github/workflows/publish.yml

@@ -0,0 +1,71 @@
+name: Publish to PyPI
+
+# Публикация по тегу вида v2.0.0 — или вручную из вкладки Actions.
+#
+# Токены не нужны: используется Trusted Publishing (OIDC). PyPI доверяет
+# именно этому репозиторию и именно этому workflow, секреты нигде не хранятся.
+#
+# Разовая настройка на стороне PyPI (делается один раз, вручную):
+#   pypi.org → Your projects → Publishing → Add a new pending publisher
+#     PyPI Project Name: ozon-mcp-server
+#     Owner:             DeviceIngineering
+#     Repository name:   ozon-mcp-server
+#     Workflow name:     publish.yml
+#     Environment name:  оставить пустым
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Сборка пакета
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Установить build
+        run: python -m pip install --upgrade build
+
+      - name: Собрать sdist и wheel
+        run: python -m build
+
+      - name: Проверить метаданные
+        run: |
+          python -m pip install --upgrade twine
+          python -m twine check dist/*
+
+      - name: Проверить, что пакет ставится и отвечает
+        run: |
+          python -m venv /tmp/check
+          /tmp/check/bin/pip install --quiet dist/*.whl
+          printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"ci","version":"1"}}}' \
+            | timeout 30 /tmp/check/bin/ozon-mcp > /tmp/out.json
+          grep -q '"name":"ozon-mcp-server"' /tmp/out.json
+          echo "stdio-сервер ответил на initialize"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Публикация на PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write   # обязательно для Trusted Publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Загрузить на PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

ozon_mcp_server-2.0.0/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.pyc
+.env
+.venv/
+data/
+*.tar.gz
+.pytest_cache/
+.DS_Store
+dist/
+build/
+*.egg-info/

ozon_mcp_server-2.0.0/DEPLOY.md

@@ -0,0 +1,119 @@
+# Деплой Ozon MCP Server на отдельный Mac mini
+
+Сервер — самодостаточный Docker-сервис. Все данные (магазины, токены, статистика,
+история диагностики) живут в Docker-томе `ozon_data`.
+
+## 1. Установка на новый Mac mini
+
+Требования: Docker Desktop (или OrbStack).
+
+```bash
+# На старом маке: упаковать проект (без данных)
+cd ~/Documents/myProjects/cowork/FBO
+tar -czf ozon-mcp-server.tar.gz --exclude='.git' --exclude='__pycache__' ozon-mcp-server
+
+# Передать на новый Mac mini
+scp ozon-mcp-server.tar.gz user@<новый-мак>:~/
+
+# На новом Mac mini:
+tar -xzf ozon-mcp-server.tar.gz && cd ozon-mcp-server
+cp .env.example .env
+# Сгенерировать токен авторизации и вписать в .env → MCP_AUTH_TOKEN
+openssl rand -hex 32
+
+docker compose up -d --build
+```
+
+Проверка: `curl http://localhost:8000/api/health` → `{"status": "ok", ...}`
+
+## 2. Перенос магазинов со старого сервера
+
+Токены хранятся зашифрованными, ключ шифрования — в том же томе,
+поэтому переносим том целиком:
+
+```bash
+# На старом маке:
+docker run --rm -v ozon-mcp-server_ozon_data:/data -v $(pwd):/backup alpine \
+  tar -czf /backup/ozon_data.tar.gz -C /data .
+scp ozon_data.tar.gz user@<новый-мак>:~/ozon-mcp-server/
+
+# На новом Mac mini (контейнер остановить на время восстановления):
+docker compose down
+docker run --rm -v ozon-mcp-server_ozon_data:/data -v $(pwd):/backup alpine \
+  sh -c "cd /data && tar -xzf /backup/ozon_data.tar.gz"
+docker compose up -d
+```
+
+Либо просто заново добавить магазины через веб-UI: `http://<новый-мак>:8000/shops`.
+
+## 3. Автозапуск после перезагрузки Mac mini
+
+`restart: unless-stopped` в docker-compose уже поднимает контейнер при старте
+Docker. Остаётся включить автозапуск Docker Desktop:
+**Docker Desktop → Settings → General → Start Docker Desktop when you sign in**.
+
+Также в macOS: **Системные настройки → Пользователи → Объекты входа** — Docker должен быть в списке.
+
+## 4. Подключение OpenClaw
+
+OpenClaw подключается к MCP по SSE. В конфигурации MCP-серверов OpenClaw
+(например `~/.openclaw/mcporter.json` или раздел `mcpServers`):
+
+```json
+{
+  "mcpServers": {
+    "ozon": {
+      "type": "sse",
+      "url": "http://<IP-мака-с-сервером>:8000/sse",
+      "headers": {
+        "Authorization": "Bearer <MCP_AUTH_TOKEN из .env>"
+      }
+    }
+  }
+}
+```
+
+Если клиент не умеет передавать заголовки — токен можно передать параметром:
+`http://<IP>:8000/sse?token=<MCP_AUTH_TOKEN>`.
+
+Подключение Claude Code с любой машины:
+
+```bash
+claude mcp add --transport sse ozon "http://<IP>:8000/sse" \
+  --header "Authorization: Bearer <MCP_AUTH_TOKEN>"
+```
+
+## 5. Сеть и безопасность
+
+- В локальной сети достаточно `MCP_AUTH_TOKEN` + статический IP/имя хоста
+  (Mac mini: Системные настройки → Сеть → зафиксировать IP, либо использовать
+  `<имя-мака>.local`).
+- **Не пробрасывайте порт 8000 в интернет напрямую.** Для доступа извне —
+  Tailscale (рекомендуется: `tailscale up`, адрес вида `100.x.y.z`) или VPN.
+- Веб-дашборд (`/`, `/shops`, `/diagnostics`) не закрыт токеном — он доступен
+  всем, кто имеет сетевой доступ к порту. В доверенной сети это ок.
+
+## 6. Диагностика
+
+| Что | Где |
+|-----|-----|
+| Здоровье сервиса + сводка | `GET /api/health` |
+| Страница диагностики (ключи, хосты, пробы, деградации) | `http://<IP>:8000/diagnostics` |
+| Запустить проверку сейчас | кнопка на странице или `POST /api/diagnostics/run` |
+| Полная диагностика магазина (JSON) | `GET /api/diagnostics/<shop_id>` |
+| Из Claude/OpenClaw | инструменты `ozon_diagnostics`, `ozon_degradations` |
+
+Фоновая проверка выполняется каждые `HEALTH_CHECK_INTERVAL_MIN` минут (по умолчанию 30):
+доступность хостов api-seller и api-performance + лёгкие реальные запросы по 12 категориям Seller API + проверка ключей Performance API.
+Результаты видны на дашборде; деградации инструментов (работал → стабильно падает)
+подсвечиваются как возможное изменение Ozon API.
+
+## 7. Обновление
+
+```bash
+cd ~/ozon-mcp-server
+# скопировать новые исходники поверх (или git pull, если репозиторий)
+docker compose up -d --build
+```
+
+Данные в томе `ozon_data` при пересборке сохраняются.

ozon_mcp_server-2.0.0/Dockerfile

@@ -0,0 +1,15 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+COPY pyproject.toml .
+COPY ozon_mcp/ ozon_mcp/
+
+RUN pip install --no-cache-dir .
+
+EXPOSE 8000
+
+ENV DATA_DIR=/data
+VOLUME /data
+
+CMD ["uvicorn", "ozon_mcp.app:fastapi_app", "--host", "0.0.0.0", "--port", "8000"]

ozon_mcp_server-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeviceIngineering
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.