Skip to main content

MCP integration and utilities for Memgraph MCP server

Project description

🚀 Memgraph MCP Server

Memgraph MCP Server is a lightweight server implementation of the Model Context Protocol (MCP) designed to connect Memgraph with LLMs.

mcp-server

Run Memgraph MCP server

  1. Install uv
  2. Install Claude for Desktop.
  3. Add the Memgraph server to Claude config

You can do it in the UI, by opening your Claude desktop app navigate to Settings, under the Developer section, click on Edit Config and add the following content:

{
    "mcpServers": {
      "mpc-memgraph": {
        "command": "uv",
        "args": [
            "run",
            "--with",
            "mcp-memgraph",
            "--python",
            "3.13",
            "mcp-memgraph"
        ]
     }
   }
}

Or you can open the config file in your favorite text editor. The location of the config file depends on your operating system:

MacOS/Linux

~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows

%APPDATA%/Claude/claude_desktop_config.json

[!NOTE]
You may need to put the full path to the uv executable in the command field. You can get this by running which uv on MacOS/Linux or where uv on Windows. Make sure you pass in the absolute path to your server.

Chat with the database

  1. Run Memgraph MAGE:
    docker run -p 7687:7687 memgraph/memgraph-mage --schema-info-enabled=True
    
    The --schema-info-enabled configuration setting is set to True to allow LLM to run SHOW SCHEMA INFO query.
  2. Open Claude Desktop and see the Memgraph tools and resources listed. Try it out! (You can load dummy data from Memgraph Lab Datasets)

🔧Tools

The Memgraph MCP Server exposes the following tools over MCP. Each tool runs a Memgraph‐toolbox operation and returns a list of records (dictionaries).

run_query(query: str)

Run any arbitrary Cypher query against the connected Memgraph database.
Parameters:

  • query: A valid Cypher query string.

get_configuration()

Fetch the current Memgraph configuration settings.
Equivalent to running SHOW CONFIGURATION.

get_index()

Retrieve information about existing indexes.
Equivalent to running SHOW INDEX INFO.

get_constraint()

Retrieve information about existing constraints.
Equivalent to running SHOW CONSTRAINT INFO.

get_schema()

Fetch the graph schema (labels, relationships, property keys).
Equivalent to running SHOW SCHEMA INFO.

get_storage()

Retrieve storage usage metrics for nodes, relationships, and properties.
Equivalent to running SHOW STORAGE INFO.

get_triggers()

List all database triggers.
Equivalent to running SHOW TRIGGERS.

get_betweenness_centrality()

Compute betweenness centrality on the entire graph.
Uses BetweennessCentralityTool under the hood.

get_page_rank()

Compute PageRank scores for all nodes.
Uses PageRankTool under the hood.

🗺️ Roadmap

The Memgraph MCP Server is just at its beginnings. We're actively working on expanding its capabilities and making it even easier to integrate Memgraph into modern AI workflows.

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

mcp_memgraph-0.1.3.tar.gz (89.8 kB view details)

Uploaded Source

Built Distribution

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

mcp_memgraph-0.1.3-py3-none-any.whl (5.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mcp_memgraph-0.1.3.tar.gz
  • Upload date:
  • Size: 89.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.5

File hashes

Hashes for mcp_memgraph-0.1.3.tar.gz
Algorithm Hash digest
SHA256 ae5d239d040b2b241b0023750b78e459dcf6b8df1f0486ef45abea67cf19c5ef
MD5 adc680dee0ebe26e5719594a4376827e
BLAKE2b-256 c4692d919db44eba1f75a540fca75d12dc976dd9eeba93e3cea56c9cf7fdaaa3

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mcp_memgraph-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 31ac688545c8a3595c3a8f1dd4431d6aeabe399a91da31432ee9e449d5f7fc3e
MD5 82ce59ccf316086022557a24a914647a
BLAKE2b-256 29f861aff58c4411111fc6fc90fea86be3c8883960cbdf80cdeb01817092dc53

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