Как запустить Neo4j MCP Server локально через Docker без GitHub Codespaces

Опубликовано руководство по локальному запуску официального Neo4j MCP Server через Docker с подключением к VS Code без GitHub Codespaces. Как пишет Towards AI, вся настройка занимает около 30 минут и не требует локальной установки Python или Neo4j, весь стек разворачивается в контейнерах.

В материале описана схема из трех компонентов. MCP-клиентом выступает VS Code, сервером, neo4j-mcp, а базой данных, Neo4j. Авторы отдельно уточняют: MCP server не является облачным сервисом. Это самостоятельная программа, которую пользователь запускает на своей машине и подключает к нужной базе данных.

Для запуска предлагается Docker Compose с образом Neo4j 5.26 и сборкой neo4j-mcp из репозитория версии v1.5.2. Сервер работает в HTTP-режиме на порту 8000, а не через stdio, как в примерах курса GraphAcademy. В инструкции говорится, что такой вариант ближе к реальному сценарию развертывания и позволяет подключать клиентов по URL.

Отдельно в гайде разбирается, почему контейнер использует порт выше 1024 и почему в HTTP-режиме не применяются переменные NEO4J_USERNAME и NEO4J_PASSWORD. Авторизация в этом случае передается через HTTP Basic Auth для каждого запроса отдельно.