Neo4j GDS

Neo4j GDS

Neo4j graph data science server with comprehensive graph algorithms that enables complex graph reasoning and Q&A.

61
Stars
12
Forks
6
Releases

Overview

This MCP Server brings together the Neo4j Graph Data Science (GDS) toolkit with an MCP Agent, enabling LLM-powered graph reasoning over a live Neo4j database. It exposes the GDS library’s common graph algorithms so an AI agent can select and parameterize the appropriate method to answer graph questions. Once the server is running, you can ask questions about your graph and receive answers computed by the relevant algorithms, enabling tasks from path finding to centrality analysis. The GDS Agent demonstrates how an LLM equipped with this tool can orchestrate multiple algorithms (e.g., shortest path, Yen's K-Shortest Paths) to support complex planning and reasoning. The repository includes a a London Underground example dataset to illustrate loading, connecting to Neo4j, and querying the graph. Start commands for development are provided (uv sync --dev, uv run gds-agent or Claude CLI), and the server can be integrated with other MCP servers.

Details

Owner
neo4j-contrib
Language
Python
License
MIT License
Updated
2025-12-07

Features

GDS Algorithm Toolkit Integration

Includes toolings from Neo4j Graph Data Science library to run common graph algorithms.

Graph Question Answering

Allows asking questions about your Neo4j graph and receiving computed answers.

Parameterized Algorithm Execution via LLMs

LLMs equipped with GDS Agent can decide and execute the appropriate parameterized graph algorithms.

Multi-Algorithm Reasoning (Shortest Path + Yen's)

Demonstrates using multiple algorithms in sequence to answer complex questions, e.g., travel planning.

London Underground Example Dataset

Provides an example dataset and workflow to load and query a graph in Neo4j using GDS.

Dev Start & Testing Workflow

Guides starting the MCP server in dev mode and running tests with pytest and code style checks.

Claude CLI Integration

Option to start Claude CLI with the GDS Agent for interactive usage.

Audience

LLM developersIntegrate LLM-powered agents with the GDS Agent to perform graph analytics over Neo4j.
Data scientistsLeverage Neo4j GDS algorithms to analyze graphs and answer complex questions via prompts.
Neo4j graph engineersExperiment with GDS-based reasoning within MCP servers to build graph-enabled AI assistants.

Tags

Neo4jGDSGraph AlgorithmsMCPAgentGraph QALLMLondon Underground