mcpField
A
ArangoDB MCP Server

ArangoDB MCP Server

Local
github.com/lucas-deangelisDatabases4Updated 79w ago
Repository

About ArangoDB MCP Server

ArangoDB MCP Server connects MCP clients to ArangoDB, exposing database and collection listing alongside AQL query execution. It supports both read-only and read-write queries.

Key features

  1. 01Execute read-only AQL queries
  2. 02Execute read-write AQL queries
  3. 03List databases
  4. 04List database collections

Use cases

  1. 01Inspect query results without modifying data
  2. 02Run AQL queries that modify data
  3. 03Discover databases on an ArangoDB server
  4. 04Find collections in a selected database

MCP support

Implements MCP tools for querying ArangoDB and listing databases and collections. It also documents a resource template for reading a document by database, collection, and ID.

#arango#database#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "arango": {
      "command": "npx",
      "args": [
        "-y",
        "arango-mcp-server"
      ]
    }
  }
}
Run commandnpx -y arango-mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmarango-mcp-server

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

ArangoDB MCP Server

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.

Todo

  • Properly study the spec to see if the current implementation of resources actually make sense (I don't think it does)
    • The resource templates make sense
  • Change all the "arango" to "arangodb" (repo name included...)
  • Add back the arangodb password
  • Proper README
    • Tools/resource/etc following the format of the official anthropic stuff
  • Figure out notifications
  • Health checks
  • More tools?
  • Access all the databases running on an arangodb instance
  • Release on npm somehow so it can be used with npx
  • resources/subscribe and notifications/resources/list_changed and resources/unsubscribe
  • Properly document tools in the readme
  • Like on the SQLite MCP client
    • write_query tool separated from read_query -> actually is readWriteQuery
    • list_collections (see list_tables)
  • Client pool ie one client per database
  • Dev environment
  • resources/read with a template to read any document by database name, collection, id.
  • Add username and passwords as parameters of the command

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.