NornicDB MCP Server

<p align="center"> <img src="https://raw.githubusercontent.com/orneryd/NornicDB/refs/heads/main/docs/assets/logos/nornicdb-logo.svg" alt="NornicDB Logo" width="200"/> </p> <h1 align="center">NornicDB</h1> <p align="center"> <strong>Graph, vector, and historical truth in one database</strong><br/> Neo4j-compatible • Hybrid graph + vector retrieval • Historical reads via MVCC<br/> <em>Achieving Psygnosis for AI</em> <p align="center"> Multi-arch support: CPU | CUDA | Metal | Vulkan <p align="center"> </p> <p align="center"> <img src="https://img.shields.io/badge/version-1.4.3-success" alt="Version 1.4.3"> <a href="https://coveralls.io/github/orneryd/NornicDB?branch=main"><img src="https://coveralls.io/repos/github/orneryd/NornicDB/badge.svg?branch=main" alt="Coveralls Report"></a> <a href="https://hub.docker.com/u/timothyswt"><img src="https://img.shields.io/badge/Docker%20Pulls-97.2K%2B-blue" alt="Docker"></a> <a href="https://neo4j.com/"><img src="https://img.shields.io/badge/neo4j-compatible-008CC1?logo=neo4j" alt="Neo4j Compatible"></a> <a href="https://github.com/qdrant/qdrant"><img src="https://img.shields.io/badge/qdrant-compatible-008CC1?logo=qdrant" alt="Qdrant Compatible"></a> <a href="https://go.dev/"><img src="https://img.shields.io/badge/go-%3E%3D1.26-00ADD8?logo=go" alt="Go Version"></a> <a href="https://goreportcard.com/report/github.com/orneryd/nornicdb"><img src="https://goreportcard.com/badge/github.com/orneryd/nornicdb" alt="Go Report Card"></a> <a href="LICENSE.md"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License"></a> </p> <p align="center"> <a href="https://discord.gg/yszYHrxp4N"><img src="https://img.shields.io/badge/discord-community-00ADD8?logo=discord" alt="Discord Community Server"></a> </p> <p align="center"> <a href="#quick-start">Quick Start</a> • <a href="#what-nornicdb-is">What It Is</a> • <a href="#why-nornicdb-is-different">Why NornicDB</a> • <a href="#performance-snapshot">Benchmarks</a> • <a href="#features">Features</a> • <a href="#documentation">Docs</a> • <a href="#comparison">Comparison</a> • <a href="#contributors">Contributors</a> </p>

Quick Start

Docker and Homebrew

# Homebrew
brew tap orneryd/nornicdb && brew install nornicdb && brew services start nornicdb

# arm64 / Apple Silicon
docker run -d --name nornicdb -p 7474:7474 -p 7687:7687 -v nornicdb-data:/data timothyswt/nornicdb-arm64-metal-bge:latest

# amd64 / CPU only
docker run -d --name nornicdb -p 7474:7474 -p 7687:7687 -v nornicdb-data:/data timothyswt/nornicdb-amd64-cpu-bge:latest

Open http://localhost:7474 for the admin UI. For an authenticated, loopback-only setup and your first query, follow the quick start guide. For NVIDIA CUDA hosts, use timothyswt/nornicdb-amd64-cuda-bge:latest. For Vulkan hosts, use timothyswt/nornicdb-amd64-vulkan-bge:latest.

---

Note: Docker on macOS does not expose Metal acceleration. The Apple Silicon image still runs, but GPU acceleration on macOS requires a native install from the releases page or a local build.

---

Local build

Install the build prerequisites, then clone, build, and start the server:

git clone https://github.com/orneryd/NornicDB.git
cd NornicDB
make build
./bin/nornicdb serve

On Windows, run .\bin\nornicdb.exe serve. See configuration for authentication and storage settings.

macOS release installer

Download the .pkg installer for your Mac from the release assets: choose arm64 for Apple Silicon or amd64 for Intel. Open the package and follow its installer prompts. Homebrew is also available above.

What NornicDB Is

NornicDB is a graph database that combines Cypher queries, graph traversal, vector search, and historical reads. It supports Bolt and HTTP interfaces and can be embedded in Go applications.

Why NornicDB Is Different

• Query connected data using Cypher and compatible Bolt drivers.
• Combine graph traversal with vector and full-text retrieval.
• Model historical state with MVCC and retained history.
• Run with CPU or supported GPU acceleration, or embed the database in a Go application.

See features, architecture, and the project details for capabilities, deployment patterns, and tradeoffs.

Performance Snapshot

Benchmark results depend on workload and hardware. Explore the performance guides, including Northwind, hybrid retrieval, and retrieval quality.

Features

• Cypher queries and functions and Neo4j migration.
• Vector search, memory policies, and agent integration.
• Transactions, historical reads, and durability.
• Embedding in Go, configuration, and deployment.

Documentation

Visit the documentation site for guides, API references, operations, and code exploration. The project details retain the full setup, features, benchmark, image, configuration, and roadmap information.

Comparison

Review the Neo4j compatibility guide, migration guides, and the documented comparisons when evaluating a migration.

Contributors

Contributions are welcome. See the contribution guide and contributors.

License

NornicDB is MIT licensed. See PATENTS.md for the defensive patent grant and NOTICES.md for third-party notices.

<p align="center"> <em>Psygnosis is a play on words or portmanteau meaning “mind" + "knowledge” in greek</em> </p>