Опубликовано руководство по локальному запуску официального 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 для каждого запроса отдельно.
Ключевые факты
В инструкции используется Neo4j 5.26 и сборка neo4j-mcp из репозитория версии v1.5.2
MCP endpoint запускается локально на порту 8000 в режиме HTTP
Для работы требуются Docker Desktop, VS Code с поддержкой MCP и терминал
В Docker-конфигурации используются плагины APOC и graph-data-science