MCP ArangoDB
Provides tools for managing ArangoDB databases, including collections, documents, queries (including AQL), and graph operations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP ArangoDBlist all collections in my database"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP ArangoDB
A Model Context Protocol (MCP) server for ArangoDB, providing full database access through MCP's standardized tool interface.
Features
Collections: Create, list, and manage document and edge collections
Documents: Full CRUD operations on documents
Queries: Simple query tools and raw AQL execution
Graphs: Graph creation, traversal, and edge management
Two Transport Modes: StdIO (for AI tool integration) and HTTP/SSE (for web-based access)
TypeScript: Full type safety with ArangoJS
95%+ Test Coverage: Unit, integration, and E2E tests
Related MCP server: MCP Server for ArangoDB
Architecture
┌─────────────────────────────────────────────────────────┐
│ AI Tool │
│ (OpenClaw, Claude Desktop, etc.) │
└─────────────────────────┬───────────────────────────────┘
│ MCP Protocol
▼
┌─────────────────────────────────────────────────────────┐
│ MCP Server │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │
│ │ Collections │ │ Documents │ │ Queries │ │
│ └─────────────┘ └─────────────┘ └─────────────────┘ │
│ ┌─────────────┐ ┌─────────────┐ │
│ │ Graphs │ │ AQL │ │
│ └─────────────┘ └─────────────┘ │
└─────────────────────────┬───────────────────────────────┘
│ ArangoJS
▼
┌─────────────────────────────────────────────────────────┐
│ ArangoDB │
│ (Document + Graph Database) │
└─────────────────────────────────────────────────────────┘Quick Start
1. Clone and Install
git clone https://github.com/TylerGarlick/mcp-arangodb.git
cd mcp-arangodb
bun install2. Start ArangoDB
docker compose up -d3. Run the MCP Server
# StdIO mode (default, for AI tool integration)
bun run dev
# Or HTTP mode (for web-based access)
bun run dev:httpAvailable Tools
Collections
Tool | Description |
| List all collections |
| Create a new collection |
| Get collection information |
| Delete a collection |
| List indexes for a collection |
Documents
Tool | Description |
| Create a document |
| Get a document by ID |
| Update a document (patch) |
| Replace a document (put) |
| Delete a document |
Queries
Tool | Description |
| Find documents matching an example |
| Find documents within a range |
| Count documents in collection |
| Execute raw AQL query |
| Generate AQL from natural language |
Graphs
Tool | Description |
| Create a named graph |
| List all graphs |
| Get graph information |
| Delete a graph |
| Execute graph traversal |
| Create an edge collection |
| Create an edge document |
| Get an edge by ID |
Documentation
Setup Guide - Installation and configuration
Usage Guide - Running the server and connecting AI tools
Novice Guide - Introduction to ArangoDB and MCP
Intermediate Guide - AQL, edges, and graphs
Advanced Guide - Performance tuning and optimization
AQL Reference - AQL syntax and examples
Testing
# Run all tests
bun test
# Run unit tests
bun run test:unit
# Run integration tests (requires ArangoDB)
bun run test:integration
# Run E2E tests
bun run test:e2e
# Run with coverage
bun run test:coverageEnvironment Variables
Variable | Description | Default |
| ArangoDB server URL |
|
| Root password | (empty) |
| HTTP server port |
|
| HTTP server host |
|
| Transport type ( |
|
Connecting to AI Tools
OpenClaw
mcp:
servers:
arangodb:
command: bun
args:
- run
- /path/to/mcp-arangodb/src/index.ts
env:
ARANGO_HOST: http://localhost:8529
ARANGO_PASSWORD: passwordClaude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"arangodb": {
"command": "bun",
"args": ["/path/to/mcp-arangodb/src/index.ts"],
"env": {
"ARANGO_HOST": "http://localhost:8529",
"ARANGO_PASSWORD": "password"
}
}
}
}License
MIT © Tyler Garlick
This server cannot be deployed
Maintenance
Related MCP Connectors
A Model Context Protocol (MCP) server for Selise Blocks Cloud integration
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
An MCP server that provides access to Testiny projects, test cases and test runs
Related MCP Servers
- AlicenseDqualityNot gradedmaintenanceA comprehensive MCP server that provides sophisticated tools for interacting with PocketBase databases. This server enables advanced database operations, schema management, and data manipulation through the Model Context Protocol (MCP).14643 npm70MIT
- AlicenseAqualityBmaintenanceA TypeScript-based server to interact with ArangoDB using the Model Context Protocol, enabling database operations and integration with tools like Claude and VSCode extensions for streamlined data management.756 npm47MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides tools for connecting to and interacting with various database systems (SQLite, PostgreSQL, MySQL/MariaDB, SQL Server) through a unified interface.3-
- AlicenseNot gradedqualityDmaintenanceA powerful Model Context Protocol (MCP) server implementation that provides standardized interaction with MongoDB databases, supporting complete CRUD operations, async patterns, and real-time updates via SSE.MIT