Amazon Neptune — MCP-сервер для Claude Code: запросы Cypher и Gremlin
MCP-сервер для графов Amazon Neptune: гоняет запросы openCypher и Gremlin, отдаёт схему графа и проверяет, доступен ли он.
Apache-2.0 ★ 9 939 обновлён 2026-10-23
Открыть на GitHubЧто делает Amazon Neptune
Сервер даёт агенту три инструмента: выполнить запрос на openCypher или Gremlin, вытащить схему графа строкой и узнать статус — «Available» или «Unavailable». Последнее помогает понять, что соединение с графом живо, до того как агент начнёт строить запросы.
Запускается через uvx awslabs.amazon-neptune-mcp-server@latest; в конфиг MCP-клиента добавляются NEPTUNE_ENDPOINT, AWS_PROFILE, AWS_REGION и уровень логов FASTMCP_LOG_LEVEL. Эндпоинт пишется в одном из двух видов: neptune-db://<Cluster Endpoint> для Neptune Database и neptune-graph://<graph identifier> для Neptune Analytics. Для Windows блок конфига другой, через uv tool run --from.
Заранее нужны настроенный AWS CLI с профилем, у которого есть доступ к Neptune, и хотя бы один граф. Neptune Database живёт в приватной VPC, поэтому машина с сервером должна в эту VPC доставать. И главное: сервер выполнит любой присланный запрос, включая изменяющий данные, так что права роли IAM ограничивайте на уровне data plane.
Какие задачи решает
- посмотреть схему графа, не открывая консоль AWS
- прогнать Gremlin-запрос к Neptune Database прямо из чата с агентом
- проверить, отвечает ли граф, перед серией запросов
- собрать openCypher-запрос к Neptune Analytics по описанию словами
- разрешить агенту разбирать связи в графе без ручного копирования выдачи
Примеры запросов агенту
- Покажи схему графа Neptune и перечисли метки вершин и рёбер
- Выполни на Neptune Analytics такой openCypher: найди все вершины с меткой Person
- Проверь статус графа, он сейчас доступен?
Как установить Amazon Neptune
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы об Amazon Neptune
Как подключить Amazon Neptune MCP Server к Claude?
Сервер прописывается в конфиг MCP-клиента. Сначала поставьте uv и Python командой uv python install 3.10, затем добавьте запись: command — uvx, args — awslabs.amazon-neptune-mcp-server@latest, в env — NEPTUNE_ENDPOINT с эндпоинтом графа, а также AWS_PROFILE и AWS_REGION.
Что делает Amazon Neptune MCP Server?
Даёт агенту выполнять запросы openCypher и Gremlin к настроенному графу, возвращает схему графа текстом и сообщает, доступен граф или нет.
Какие права нужны роли IAM для этого сервера?
Доступ к Neptune и право выполнять запросы. Сервер отправит в граф любой запрос, включая изменяющий данные, поэтому набор разрешённых действий data plane стоит задать явно. Для Neptune Database ещё нужен сетевой доступ в приватную VPC.