zeegin / zeegin/v8std

Готовый Docker-образ для локального MCP (публикация в Docker Hub)

Open
#32 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
124
Forks
26
Avg merge
3d 18h
Merged PRs (30d)
5

Description

Проблема

Локальный запуск MCP сейчас требует клонировать репозиторий и собирать образ на месте (docker-compose/docker-compose.yml). Это лишний барьер для тех, кто хочет просто подключить v8std к ИИ-редактору.

Предложение

Публиковать самодостаточный образ MCP: база стандартов и поисковый индекс генерируются на этапе сборки, монтирование репозитория не нужно. База — python:3.12-alpine, итоговый образ ~305 МБ (против ~485 МБ у текущего slim-варианта с zensical, который MCP не нужен).

Запуск без клона:

docker run -d --name v8std-mcp -p 127.0.0.1:8765:8765 malikovpro/v8std-mcp:latest
codex mcp add v8std-local --url http://127.0.0.1:8765/mcp
Что уже сделано
  • Образ собран и опубликован: https://hub.docker.com/repository/docker/malikovpro/v8std-mcp — теги latest, датированные (2026-09-01) и по коммиту (sha-…), пока только linux/amd64 (arm64 — через setup-qemu в CI).
  • Подготовлена ветка: отдельный стек docker-compose-mcp-only/ (compose + Dockerfile.mcp), существующий docker-compose/ не изменён, workflow автоматической пересборки, скрипт сборки со smoke-тестом. PR пришлю следом.
Попутный багфикс

Pillow не объявлен в requirements-mcp.txt, хотя generate_ai_artifacts.py импортирует generate_social_cards.py на верхнем уровне. Сейчас зависимость приходит только транзитивно через окружение с zensical — локальный MCP в чистом окружении падает с ModuleNotFoundError: No module named 'PIL'. В ветке Pillow добавлен явно (с пинами версий, имеющими musllinux-колёса).

Открытые вопросы
  1. Namespace. Образ опубликован в malikovpro/v8std-mcp. Если проекту удобнее официальный образ под своим именем — workflow параметризован (vars.DOCKERHUB_IMAGE + secrets DOCKERHUB_USERNAME/DOCKERHUB_TOKEN), достаточно сменить имя.
  2. Обновление образа. Пересборка при изменениях docs/**/scripts/** уже настроена в workflow из PR. Нужен ли дополнительно запуск по расписанию?

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing docker-compose-mcp-only/, Dockerfile.mcp, the requirements-mcp.txt dependency change, and the automated rebuild workflow, then compare them with docker-compose/docker-compose.yml. Confirm the image build and smoke test, the Pillow fix, the Docker Hub namespace, and whether scheduled rebuilds are required; the issue is done when these decisions are resolved and the self-contained MCP image is reproducibly published.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, docker-compose, github-actions, python
Domain
api, build-system, devops
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.