ArangoDB Graph

ArangoDB Graph

Async-first MCP server exposing ArangoDB operations to AI assistants with graph management.

2
Stars
2
Forks
0
Releases

Overview

A production-ready Model Context Protocol (MCP) server designed to expose advanced ArangoDB operations to AI assistants such as Claude Desktop and Augment Code. Built with an async-first Python architecture and wrapping the official python-arango driver, it offers comprehensive graph management, flexible content conversion (JSON, Markdown, YAML, and Table), backup/restore capabilities, and graph analytics. The server provides 43 MCP tools across ten categories, including core data operations, indexing, query analysis, data validation, bulk operations, graph management, traversal, backup/restore, analytics, and MCP design-pattern tooling. It emphasizes type safety via Pydantic validation for all tool arguments and supports dual transport modes (stdio for desktop clients and HTTP for web or containerized deployments). Docker support enables isolated, reproducible deployments. The architecture envisions an MCP client interface, a Python-based MCP server, and a live ArangoDB instance, delivering production-grade retry logic, graceful degradation, and robust error handling. Documentation and examples cover installation, configuration, and common use cases such as codebase graph analysis and scalable graph operations in real-world apps.

Details

Owner
PCfVW
Language
Python
License
Updated
2025-12-07

Features

43 MCP Tools

Complete ArangoDB operations (queries, collections, indexes, graphs) exposed as MCP tools.

MCP Design Patterns

Progressive discovery, context switching, and tool unloading with efficiency token savings.

Graph Management

Create, traverse, backup/restore named graphs.

Content Conversion

Support for JSON, Markdown, YAML, and Table content formats.

Backup/Restore

Backup collections and graphs with validation.

Analytics

Query profiling, explain plans, graph statistics.

Dual Transport

Supports stdio (desktop clients) and HTTP (web/containerized deployments).

Docker & Production-Ready

Docker support with isolation and reproducibility; retry logic and robust error handling.

Audience

AI assistantsExpose ArangoDB operations via MCP for chat-based DB management and analytics.
DevelopersWraps ArangoDB on MCP for programmatic graph operations and tooling.

Tags

ArangoDBMCPPythonasyncGraph managementContent conversionBackup/RestoreAnalyticsAQLPydanticdockerstdiohttp