Skip to main content
Glama
NebulaGraph MCP Server

NebulaGraph MCP Server

Model Context Protocol Server for NebulaGraph

A Model Context Protocol (MCP) server implementation that provides access to NebulaGraph.

PyPI - Version PyPI - Python Version Lint and Test

Features

  • Seamless access to NebulaGraph 3.x .

  • Get ready for graph exploration, you know, Schema, Query, and a few shortcut algorithms.

  • Follow Model Context Protocol, ready to integrate with LLM tooling systems.

  • Simple command-line interface with support for configuration via environment variables and .env files.

LlamaIndex with NebulaGraph MCP

Related MCP server: mcp-graphql

Installation

pip install nebulagraph-mcp-server

Usage

nebulagraph-mcp-server will load configs from .env, for example:

NEBULA_VERSION=v3 # only v3 is supported
NEBULA_HOST=<your-nebulagraph-server-host>
NEBULA_PORT=<your-nebulagraph-server-port>
NEBULA_USER=<your-nebulagraph-server-user>
NEBULA_PASSWORD=<your-nebulagraph-server-password>

It requires the value of NEBULA_VERSION to be equal to v3 until we are ready for v5.

Development

npx @modelcontextprotocol/inspector \
  uv run nebulagraph-mcp-server

Credits

The layout and workflow of this repo is copied from mcp-server-opendal.

Available Tools

5 tools
execute_queryC

Execute a query Args: query: The query to execute space: The space to use Returns: The results of the query

Inputs: query (required), space (required).

find_neighborsC

Find the neighbors of the specified vertex Args: vertex: The vertex ID to query space: The space to use depth: The depth of the query, default is 1 Returns: The neighbors of the specified vertex

Inputs: vertex (required), space (required), depth.

find_pathC

Find paths between two vertices Args: src: The source vertex ID dst: The destination vertex ID space: The space to use depth: The maximum path depth limit: The maximum number of paths to return Returns: The path results

Inputs: src (required), dst (required), space (required), depth, +1 more.

get_space_schemaC

Get the schema information of the specified space Args: space: The space to get the schema for Returns: The schema information of the specified space

Inputs: space (required).

list_spacesC

List all available spaces Returns: The available spaces

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: execute_query for general queries, find_neighbors for vertex adjacency, find_path for pathfinding, get_space_schema for schema inspection, and list_spaces for space enumeration. The descriptions reinforce these distinct functions, making tool selection unambiguous.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., execute_query, find_neighbors, list_spaces) with clear, descriptive verbs. There are no deviations in style or convention, making the naming predictable and easy to understand across the set.

    Tool Count5/5

    With 5 tools, this server is well-scoped for graph database operations, covering essential functions like querying, traversal, pathfinding, and schema management. Each tool earns its place without feeling excessive or insufficient for the domain.

    Completeness4/5

    The tool set provides strong coverage for core graph operations, including query execution, neighbor and path finding, and space/schema inspection. A minor gap exists in CRUD operations for vertices or edges (e.g., create, update, delete), but agents can likely work around this with queries.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      A Model Context Protocol server implementation that enables AI assistants to securely interact with GreptimeDB, allowing them to explore database schema, read data, and execute SQL queries through a controlled interface.
      15
      29
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables LLMs to interact with GraphQL APIs by providing schema introspection and query execution capabilities.
      3
      MIT
    • A
      license
      C
      quality
      Not graded
      maintenance
      A lightweight server implementation of the Model Context Protocol that connects Memgraph database with LLMs, allowing users to interact with graph databases through natural language.
      1
      25
      MIT