mcp-neo4j-cypher — MCP-сервер для Claude Code: Cypher-запросы
MCP-сервер, через который агент читает и меняет граф в Neo4j: выполняет Cypher-запросы и выгружает схему базы.
claude mcp add --env NEO4J_URI=<NEO4J_URI> --env NEO4J_USERNAME=<NEO4J_USERNAME> --env NEO4J_PASSWORD=<NEO4J_PASSWORD> --env NEO4J_DATABASE=<NEO4J_DATABASE> --env NEO4J_NAMESPACE=<NEO4J_NAMESPACE> --transport stdio mcp-neo4j-cypher -- uvx mcp-neo4j-cypherЧто делает mcp-neo4j-cypher
Сервер даёт агенту три инструмента. read_neo4j_cypher выполняет читающие запросы и отдаёт строки как JSON, write_neo4j_cypher — обновляющие, с ответом в виде счётчиков затронутых узлов и созданных связей. Третий, get_neo4j_schema, перечисляет типы узлов с атрибутами и связями между ними.
Для схемы нужен плагин APOC, включённый на инстансе: без него get_neo4j_schema не заработает. Сама база — запущенный Neo4j, Aura или self-managed. Чтение по умолчанию обрывается через 30 секунд, порог меняется флагом --read-timeout или переменной NEO4J_READ_TIMEOUT. Длинные ответы режет лимит токенов (--token-limit, NEO4J_RESPONSE_TOKEN_LIMIT), усечение идёт через tiktoken.
Если баз несколько, задайте пространство имён: имена инструментов получат префикс вроде mydb-read_neo4j_cypher. Запись отключается флагом --read-only или NEO4J_READ_ONLY=true, тогда агент видит только чтение. Схему на большой базе снимайте с выборкой — по умолчанию на каждый лейбл берётся 1000 узлов, -1 означает полный проход.
Какие задачи решает
- собрать выборку из графа запросом на Cypher
- обновить узлы и связи прямо из диалога с агентом
- получить схему базы перед генерацией запроса
- удержать большой ответ в лимите токенов модели
- подключить два инстанса Neo4j в одной сессии
Примеры запросов агенту
- Выполни в Neo4j запрос: какие узлы
Customerсвязаны с заказом 42? - Покажи схему базы
mydb— какие лейблы и связи там есть - Добавь в граф узел
Projectс именем «NeVibe» и привяжи его к владельцу
Как установить mcp-neo4j-cypher
Командой платформы
claude mcp add --env NEO4J_URI=<NEO4J_URI> --env NEO4J_USERNAME=<NEO4J_USERNAME> --env NEO4J_PASSWORD=<NEO4J_PASSWORD> --env NEO4J_DATABASE=<NEO4J_DATABASE> --env NEO4J_NAMESPACE=<NEO4J_NAMESPACE> --transport stdio mcp-neo4j-cypher -- uvx mcp-neo4j-cypherВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-neo4j-cypher <команда>
Командой платформы
codex mcp add mcp-neo4j-cypher --env NEO4J_URI=<NEO4J_URI> --env NEO4J_USERNAME=<NEO4J_USERNAME> --env NEO4J_PASSWORD=<NEO4J_PASSWORD> --env NEO4J_DATABASE=<NEO4J_DATABASE> --env NEO4J_NAMESPACE=<NEO4J_NAMESPACE> -- uvx mcp-neo4j-cypherВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-neo4j-cypher <команда>
Файл настроек
{
"mcpServers": {
"mcp-neo4j-cypher": {
"command": "uvx",
"args": [
"mcp-neo4j-cypher"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
"NEO4J_DATABASE": "<NEO4J_DATABASE>",
"NEO4J_NAMESPACE": "<NEO4J_NAMESPACE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-neo4j-cypher <команда>
Файл настроек
{
"servers": {
"mcp-neo4j-cypher": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-neo4j-cypher"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
"NEO4J_DATABASE": "<NEO4J_DATABASE>",
"NEO4J_NAMESPACE": "<NEO4J_NAMESPACE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-neo4j-cypher <команда>
Командой платформы
gemini mcp add -e NEO4J_URI=<NEO4J_URI> -e NEO4J_USERNAME=<NEO4J_USERNAME> -e NEO4J_PASSWORD=<NEO4J_PASSWORD> -e NEO4J_DATABASE=<NEO4J_DATABASE> -e NEO4J_NAMESPACE=<NEO4J_NAMESPACE> mcp-neo4j-cypher uvx mcp-neo4j-cypherВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-neo4j-cypher <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-neo4j-cypher
Как установить mcp-neo4j-cypher в Claude Code?
Одной командой: `claude mcp add mcp-neo4j-cypher -e NEO4J_URI=<NEO4J_URI> -e NEO4J_USERNAME=<NEO4J_USERNAME> -e NEO4J_PASSWORD=<NEO4J_PASSWORD> -- uvx mcp-neo4j-cypher`. Вместо плейсхолдеров подставьте адрес базы, логин и пароль.
Что делает mcp-neo4j-cypher?
Даёт агенту три инструмента: чтение Cypher, запись Cypher и выгрузку схемы графа. Агент сам собирает запрос под вопрос, заданный обычным языком.
Что нужно для работы get_neo4j_schema?
Плагин APOC, установленный и включённый на инстансе Neo4j. Без него инструмент схемы не отработает, остальные два продолжат работать.
