English Français العربية

io.github.neo4j-contrib/mcp-neo4j-cypher

السجل الرسمي البيانات وقواعدها

A simple Neo4j MCP server that allows you to run Cypher queries against a Neo4j database.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package mcp-neo4j-cypher
Claude Code 
claude mcp add mcp-neo4j-cypher -e 'NEO4J_URI=<NEO4J_URI>' -e 'NEO4J_USERNAME=<NEO4J_USERNAME>' -e 'NEO4J_PASSWORD=<your neo4j_password>' -e 'NEO4J_DATABASE=<NEO4J_DATABASE>' -e 'NEO4J_NAMESPACE=<NEO4J_NAMESPACE>' -e 'NEO4J_RESPONSE_TOKEN_LIMIT=<NEO4J_RESPONSE_TOKEN_LIMIT>' -e 'NEO4J_READ_TIMEOUT=<NEO4J_READ_TIMEOUT>' -e 'NEO4J_READ_ONLY=<NEO4J_READ_ONLY>' -e 'NEO4J_SCHEMA_SAMPLE_SIZE=<NEO4J_SCHEMA_SAMPLE_SIZE>' -- uvx mcp-neo4j-cypher==0.5.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mcp-neo4j-cypher": {
            "command": "uvx",
            "args": [
                "mcp-neo4j-cypher==0.5.1"
            ],
            "env": {
                "NEO4J_URI": "<NEO4J_URI>",
                "NEO4J_USERNAME": "<NEO4J_USERNAME>",
                "NEO4J_PASSWORD": "<your neo4j_password>",
                "NEO4J_DATABASE": "<NEO4J_DATABASE>",
                "NEO4J_NAMESPACE": "<NEO4J_NAMESPACE>",
                "NEO4J_RESPONSE_TOKEN_LIMIT": "<NEO4J_RESPONSE_TOKEN_LIMIT>",
                "NEO4J_READ_TIMEOUT": "<NEO4J_READ_TIMEOUT>",
                "NEO4J_READ_ONLY": "<NEO4J_READ_ONLY>",
                "NEO4J_SCHEMA_SAMPLE_SIZE": "<NEO4J_SCHEMA_SAMPLE_SIZE>"
            }
        }
    }
}

متغيرات البيئة

  • NEO4J_URI إلزامي Neo4j connection URI
  • NEO4J_USERNAME إلزامي Neo4j username
  • NEO4J_PASSWORD إلزامي سري Neo4j password
  • NEO4J_DATABASE Neo4j database name
  • NEO4J_NAMESPACE Tool namespace prefix
  • NEO4J_RESPONSE_TOKEN_LIMIT Maximum tokens for read query responses
  • NEO4J_READ_TIMEOUT Timeout in seconds for read queries
  • NEO4J_READ_ONLY Allow only read-only queries (true/false)
  • NEO4J_SCHEMA_SAMPLE_SIZE Schema sample size

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Neo4j Labs MCP Servers
  2. Neo4j Labs
  3. Overview
  4. Servers
  5. Transport Modes
  6. Cloud Deployment
  7. Contributing
  8. Blog Posts
  9. License

Neo4j Labs MCP Servers

Neo4j Labs

These MCP servers are a part of the Neo4j Labs program. They are developed and maintained by the Neo4j Field GenAI team and welcome contributions from the larger developer community. These servers are frequently updated with new and experimental features, but are not supported by the Neo4j product team.

They are actively developed and maintained, but we don’t provide any SLAs or guarantees around backwards compatibility and deprecation.

If you are looking for the official product Neo4j MCP server please find it here.

Overview

Model Context Protocol (MCP) is a standardized protocol for managing context between large language models (LLMs) and external systems.

This lets you use Claude Desktop, or any other MCP Client (VS Code, Cursor, Windsurf, Gemini CLI), to use natural language to accomplish things with Neo4j and your Aura account, e.g.:

  • What is in this graph?
  • Render a chart from the top products sold by frequency, total and average volume
  • List my instances
  • Create a new instance named mcp-test for Aura Professional with 4GB and Graph Data Science enabled
  • Store the fact that I worked on the Neo4j MCP Servers today with Andreas and Oskar

Servers

mcp-neo4j-cypher - natural language to Cypher queries

Details in Readme

Get database schema for a configured database and execute generated read and write Cypher queries on that database.

Requirement: Requires the APOC plugin to be installed and enabled on the Neo4j instance for schema inspection.

mcp-neo4j-memory - knowledge graph memory stored in Neo4j

Details in Readme

Store and retrieve entities and relationships from your personal knowledge graph in a local or remote Neo4j instance. Access that information over different sessions, conversations, clients.

mcp-neo4j-cloud-aura-api - Neo4j Aura cloud service management API

Details in Readme

Manage your Neo4j Aura instances directly from the comfort of your AI assistant chat.

Create and destroy instances, find instances by name, scale them up and down and enable features.

mcp-neo4j-data-modeling - interactive graph data modeling and visualization

Details in Readme

Create, validate, and visualize Neo4j graph data models. Allows for model import/export from Arrows.app.

Transport Modes

All servers support multiple transport modes:

  • STDIO (default): Standard input/output for local tools and Claude Desktop integration
  • SSE: Server-Sent Events for web-based deployments
  • HTTP: Streamable HTTP for modern web deployments and microservices
HTTP Transport Configuration

To run a server in HTTP mode, use the --transport http flag:

# Basic HTTP mode
mcp-neo4j-cypher --transport http

# Custom HTTP configuration
mcp-neo4j-cypher --transport http --host 127.0.0.1 --port 8080 --path /api/mcp/

Environment variables are also supported:

export NEO4J_TRANSPORT=http
export NEO4J_MCP_SERVER_HOST=127.0.0.1
export NEO4J_MCP_SERVER_PORT=8080
export NEO4J_MCP_SERVER_PATH=/api/mcp/
mcp-neo4j-cypher

Cloud Deployment

All servers in this repository are containerized and ready for cloud deployment on platforms like AWS ECS Fargate and Azure Container Apps. Each server supports HTTP transport mode specifically designed for scalable, production-ready deployments with auto-scaling and load balancing capabilities.

📋 Complete Cloud Deployment Guide →

The deployment guide covers:

  • AWS ECS Fargate: Step-by-step deployment with auto-scaling and Application Load Balancer
  • Azure Container Apps: Serverless container deployment with built-in scaling and traffic management
  • Configuration Best Practices: Security, monitoring, resource recommendations, and troubleshooting
  • Integration Examples: Connecting MCP clients to cloud-deployed servers

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Blog Posts

License

MIT License

الأسئلة الشائعة

ما هو io.github.neo4j-contrib/mcp-neo4j-cypher؟

A simple Neo4j MCP server that allows you to run Cypher queries against a Neo4j database.

كيف أثبّت io.github.neo4j-contrib/mcp-neo4j-cypher؟

يعمل على جهازك. في Claude Code: claude mcp add mcp-neo4j-cypher -e 'NEO4J_URI=<NEO4J_URI>' -e 'NEO4J_USERNAME=<NEO4J_USERNAME>' -e 'NEO4J_PASSWORD=<your neo4j_password>' -e 'NEO4J_DATABASE=<NEO4J_DATABASE>' -e 'NEO4J_NAMESPACE=<NEO4J_NAMESPACE>' -e 'NEO4J_RESPONSE_TOKEN_LIMIT=<NEO4J_RESPONSE_TOKEN_LIMIT>' -e 'NEO4J_READ_TIMEOUT=<NEO4J_READ_TIMEOUT>' -e 'NEO4J_READ_ONLY=<NEO4J_READ_ONLY>' -e 'NEO4J_SCHEMA_SAMPLE_SIZE=<NEO4J_SCHEMA_SAMPLE_SIZE>' -- uvx mcp-neo4j-cypher==0.5.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.neo4j-contrib/mcp-neo4j-cypher إلى مفتاح API؟

نعم. يتطلب NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD، وتضبطها في إعداداته.

هل io.github.neo4j-contrib/mcp-neo4j-cypher مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.neo4j-contrib/mcp-neo4j-cypher؟

ينشره neo4j-contrib. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.