Overview
What is ArangoDB MCP Server?
The ArangoDB MCP Server is an implementation of the Model Context Protocol (MCP) for ArangoDB, enabling AI models to query and interact with ArangoDB databases. It provides tools for executing AQL queries, listing databases and collections, and reading documents via resource templates.
How to use ArangoDB MCP Server?
Configure the server in your MCP client (e.g., Claude Desktop) by adding an entry to claude_desktop_config.json with the command npx -y arango-mcp-server followed by the ArangoDB URL, username, and password. The server exposes tools for running read‑only or read‑write AQL queries, listing databases and collections, and accessing documents through resource templates.
Key features of ArangoDB MCP Server
- Execute read‑only AQL queries with
readQuery - Execute any AQL query (including writes) with
readWriteQuery - List all databases on an ArangoDB server with
listDatabases - List all collections in a database with
listCollections - Read documents by database, collection, and ID via resource templates
- Client pool – one client per database for efficient connections
Use cases of ArangoDB MCP Server
- Query ArangoDB databases directly from an AI assistant
- Browse available databases and collections without leaving the chat interface
- Read specific documents by ID using resource templates
- Perform data updates or inserts through read‑write queries
- Integrate ArangoDB into workflows that use the Model Context Protocol
FAQ from ArangoDB MCP Server
What tools does ArangoDB MCP Server provide?
The server provides readQuery (read‑only AQL), readWriteQuery (any AQL), listDatabases (list all databases), and listCollections (list collections in a database). It also supports reading documents via resource templates.
How do I connect ArangoDB MCP Server to my ArangoDB instance?
Add an entry to your MCP client configuration (e.g., claude_desktop_config.json) with the command npx -y arango-mcp-server followed by the ArangoDB URL, username, and password. For example: "args": ["-y", "arango-mcp-server", "http://localhost:8529", "root", "root"].
Does ArangoDB MCP Server require a password?
Yes. The example configuration includes a password argument (e.g., "root"). The project's todo list mentions adding the password back, implying it is required for authentication.
What runtime does ArangoDB MCP Server depend on?
It is distributed as an npm package and invoked via npx. A Node.js runtime is required.
