arango mcp server

Local 2025-08-31 23:51:33 0

databases @lucas-deangelis/arango-mcp-server

An implementation of the Model Context Protocol that enables interaction with ArangoDB databases, allowing users to perform queries, list databases and collections through natural language.

This is an implementation of the Model Context Protocol for ArangoDB.

Overview

To be filled.

Components

Resources

Tools

Query Tools

readQuery
Execute read-only query on the database
Input:
- databaseName (string): The database to query
- aql (string): The read-only AQL query to execute
Returns: Query results as array of objects
readWriteQuery
Execute query on the database
Input:
- databaseName (string): The database to query
- aql (string): The AQL query to execute
Returns: Query results as array of objects
listDatabases
List all the databases on the ArangoDB server
Returns: Array of the databases names
listCollections
List all the collections in an ArangoDB database
Input:
- databaseName (string): The name of the database
Returns: Array of objects { "name": "<collectionName>" }

Usage

To connect to an arangodb instance running on localhost:2434, to the database "account", add the following to your claude_desktop_config.json, assuming the path to this project is /home/yourcoolname/arango-mcp-server:

{
  "mcpServers": {
    "arangodb-account": {
      "command": "npx",
      "args": [
        "-y",
        "arango-mcp-server",
        "http://localhost:8529",
        "root",
        "root"
      ]
    }
  }
}

Development

Clone the repository. Install everything. Setup the dev environment. Run the watcher. Edit index.ts.

$ npm install
$ npm run dev:setup
$ npm run dev

Go to http://localhost:5173/ to see the inspector.