Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

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

Open
  • Is something wrong?
#32 0 comments 0 reactions 0 assignees View on GitHub

@malikov-pro is already working on this.

Since Sep 1, 2026.

  • #33 by @malikov-pro — open

Assessment

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

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.

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. Нужен ли дополнительно запуск по расписанию?
Dominant language
Python
Stars
136
Forks
26
Avg merge
40m
Merged PRs (30d)
6

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

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.

More from zeegin/v8std

All issues in zeegin/v8std

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.