https://github.com/nebula-contrib/nebulagraph-mcp-server

Model Context Protocol Server for NebulaGraph 3.x
https://github.com/nebula-contrib/nebulagraph-mcp-server

agent genai llm mcp nebulagraph

Last synced: 6 days ago
JSON representation

Model Context Protocol Server for NebulaGraph 3.x

• Host: GitHub
• URL: https://github.com/nebula-contrib/nebulagraph-mcp-server
• Owner: nebula-contrib
• License: apache-2.0
• Created: 2025-03-10T16:44:15.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2025-03-17T16:04:17.000Z (3 months ago)
• Last Synced: 2025-06-09T12:53:17.479Z (11 days ago)
• Topics: agent, genai, llm, mcp, nebulagraph
• Language: Python
• Homepage: https://pypi.org/project/nebulagraph-mcp-server/
• Size: 857 KB
• Stars: 17
• Watchers: 4
• Forks: 4
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: changelogithub.config.json
  • License: LICENSE

Awesome Lists containing this project

• mcp-index - NebulaGraph Server - Provides access to NebulaGraph 3.x for graph exploration, including schema management, query execution, and shortcut algorithms, compliant with the Model Context Protocol. (Cloud Services)

README

        
# Model Context Protocol Server for NebulaGraph

A Model Context Protocol (MCP) server implementation that provides access to [NebulaGraph](https://github.com/vesoft-inc/nebula).

[![PyPI - Version](https://img.shields.io/pypi/v/nebulagraph-mcp-server)](https://pypi.org/project/nebulagraph-mcp-server/)

[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/nebulagraph-mcp-server)](https://pypi.org/project/nebulagraph-mcp-server/)

[![Lint and Test](https://github.com/PsiACE/nebulagraph-mcp-server/actions/workflows/test.yml/badge.svg)](https://github.com/PsiACE/nebulagraph-mcp-server/actions/workflows/test.yml)

## 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](./assets/llamaindex-with-nebulagraph-mcp.png)

## Installation

```shell

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=

NEBULA_PORT=

NEBULA_USER=

NEBULA_PASSWORD=

```

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

## Development

```shell

npx @modelcontextprotocol/inspector \

  uv run nebulagraph-mcp-server

```

## Credits

The layout and workflow of this repo is copied from [mcp-server-opendal](https://github.com/Xuanwo/mcp-server-opendal).