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.3.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.3-py3-none-any.whl (14.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: neo4j_mcp-0.1.3.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.3.tar.gz
Algorithm Hash digest
SHA256 7230e125fb802364b815adb06671ef55ce5fe07cadb4ae56596ba822b2fae20f
MD5 c7aa79a18b06344feddff29f66445d6b
BLAKE2b-256 1556c69de08d6e707b78ccc3cb5618db6eef2dfd54ed41b2e41f7de764f43634

See more details on using hashes here.

File details

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

File metadata

  • Download URL: neo4j_mcp-0.1.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 883b6877460bbc44715cb9d3bd79bbc9f2fa231f012b1a6c385580229bffb6e0
MD5 dac8042b732da37becf2af3ac060ba56
BLAKE2b-256 ddc8f06864d58e254892bc054babbafb5886e8c565c23d121f3388933c788103

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