Skip to main content

MCP server for Neo4j graph database operations

Project description

neo4j-mcp

Code style: crackerjack Runtime: oneiric Framework: FastMCP uv Python: 3.13+

MCP server for Neo4j graph database operations.

Installation

uv pip install -e .

Usage

# Stdio mode (default)
neo4j-mcp serve

# HTTP mode
neo4j-mcp serve --http --port 3045

# With mock mode for testing
neo4j-mcp serve --mock

# With custom connection
neo4j-mcp serve --uri bolt://localhost:7687 --database neo4j

Tools

Queries:

  • run_cypher - Execute Cypher queries

Nodes:

  • create_node - Create a node
  • get_node - Get node by ID
  • delete_node - Delete a node
  • find_nodes - Find nodes by criteria

Relationships:

  • create_relationship - Create relationship
  • delete_relationship - Delete relationship

Paths:

  • find_paths - Find paths between nodes

Schema:

  • get_schema - Get database schema info

Configuration

Set via environment variables with NEO4J_MCP_ prefix:

  • NEO4J_MCP_URI - Neo4j URI (default: bolt://localhost:7687)
  • NEO4J_MCP_USER - Username (default: neo4j)
  • NEO4J_MCP_PASSWORD - Password
  • NEO4J_MCP_DATABASE - Database name (default: neo4j)
  • NEO4J_MCP_MOCK_MODE - Enable mock mode

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

neo4j_mcp-0.1.2.tar.gz (238.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

neo4j_mcp-0.1.2-py3-none-any.whl (14.8 kB view details)

Uploaded Python 3

File details

Details for the file neo4j_mcp-0.1.2.tar.gz.

File metadata

  • Download URL: neo4j_mcp-0.1.2.tar.gz
  • Upload date:
  • Size: 238.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.12 {"installer":{"name":"uv","version":"0.11.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for neo4j_mcp-0.1.2.tar.gz
Algorithm Hash digest
SHA256 f3f6dc691a6f7b836a36b0087dc4ecd91c619d77a3b2f4acd36e8304c7eba5de
MD5 e7b8b20d57ce3846d53f05d76d7a321a
BLAKE2b-256 031f067f42a35dc563dc673a1db3cd5a8ac0929c013381833a17f480df23c163

See more details on using hashes here.

File details

Details for the file neo4j_mcp-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: neo4j_mcp-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 14.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.12 {"installer":{"name":"uv","version":"0.11.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for neo4j_mcp-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 3c86254746a180fc56acc19226eeccd378b926486d6ee57dcf845b374bad455a
MD5 d47f2fb32e3cc62faf81d509b3232c93
BLAKE2b-256 b1bcb98d632e191e209f494c6485b8e45f6ba78f4600edc67e4d443d6c59922e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page