MCP Server for ArangoDB
A Model Context Protocol server for ArangoDB
This is a TypeScript-based MCP server that provides database interaction capabilities through ArangoDB. It implements core database operations and allows seamless integration with ArangoDB through MCP tools. You can use it wih Claude app and also extension for VSCode that works with mcp like Cline!
Features
Tools
arango_query- Execute AQL queries
arango_insert- Insert documents into collections
arango_update- Update existing documents
arango_remove- Remove documents from collections
arango_backup- Backup all collections to JSON files
arango_list_collections- List all collections in the database
arango_create_collection- Create a new collection in the database
Installation
Installing via NPM
To install
arango-server globally via NPM, run the following command:Running via NPX
To run
arango-server directly without installation, use the following command:Configuring for VSCode Agent
To use
arango-server with the VSCode Copilot agent, you must have at least VSCode 1.99.0 installed and follow these steps:- Create or edit the MCP configuration file: Tip: You can refer [here](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) to the MCP configuration documentation of VSCode for more details on how to set up the configuration file.
- Add the following configuration:
- Start the MCP server:
- Verify the server:
Installing via Smithery
To install ArangoDB for Claude Desktop automatically via Smithery:
To use with Claude Desktop
Go to:
Settings > Developer > Edit Config or- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%/Claude/claude_desktop_config.json
To use with Cline VSCode Extension
Go to:
Cline Extension > MCP Servers > Edit Configuration or- MacOS:
~/Library/Application Support/Code/User/globalStorage/cline.cline/config.json
- Windows:
%APPDATA%/Code/User/globalStorage/cline.cline/config.json
Add the following configuration to the
mcpServers section:Environment Variables
The server requires the following environment variables:
ARANGO_URL- ArangoDB server URL (note: 8529 is the default port for ArangoDB for local development)
ARANGO_DB- Database name
ARANGO_USERNAME- Database user
ARANGO_PASSWORD- Database password
Usage
You can pretty much provide any meaningful prompt and Claude will try to execute the appropriate function.
Some example propmts:
- "List all collections in the database"
- "Query all users"
- "Insert a new document with name 'John Doe' and email "john@example.com' to the 'users' collection"
- "Update the document with key '123456' or name 'Jane Doe' to change the age to 48"
- "Create a new collection named 'products'"
Usage with Claude App
Demo of using ArangoDB MCP server with Claude App
Uasge with Cline VSCode extension
Demo of using ArangoDB MCP server with Cline VSCode extension
Query all users:
Insert a new document:
Update a document:
Remove a document:
List all collections:
Backup database collections:
Create a new collection:
Note: The server is database-structure agnostic and can work with any collection names or structures as long as they follow ArangoDB's document and edge collection models.
Development
- Clone the repository
- Install dependencies:
- For development with auto-rebuild:
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. recommended debugging can be done by using MCP Inspector for development:
The Inspector will provide a URL to access debugging tools in your browser.
License
This project is licensed under the MIT License - see the LICENSE file for details.
MCP Server for ArangoDB
A Model Context Protocol server for ArangoDB
This is a TypeScript-based MCP server that provides database interaction capabilities through ArangoDB. It implements core database operations and allows seamless integration with ArangoDB through MCP tools. You can use it wih Claude app and also extension for VSCode that works with mcp like Cline!
Features
Tools
arango_query- Execute AQL queries
arango_insert- Insert documents into collections
arango_update- Update existing documents
arango_remove- Remove documents from collections
arango_backup- Backup all collections to JSON files
arango_list_collections- List all collections in the database
arango_create_collection- Create a new collection in the database
Installation
Installing via NPM
To install
arango-server globally via NPM, run the following command:Running via NPX
To run
arango-server directly without installation, use the following command:Configuring for VSCode Agent
To use
arango-server with the VSCode Copilot agent, you must have at least VSCode 1.99.0 installed and follow these steps:- Create or edit the MCP configuration file: Tip: You can refer [here](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) to the MCP configuration documentation of VSCode for more details on how to set up the configuration file.
- Add the following configuration:
- Start the MCP server:
- Verify the server:
Installing via Smithery
To install ArangoDB for Claude Desktop automatically via Smithery:
To use with Claude Desktop
Go to:
Settings > Developer > Edit Config or- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%/Claude/claude_desktop_config.json
To use with Cline VSCode Extension
Go to:
Cline Extension > MCP Servers > Edit Configuration or- MacOS:
~/Library/Application Support/Code/User/globalStorage/cline.cline/config.json
- Windows:
%APPDATA%/Code/User/globalStorage/cline.cline/config.json
Add the following configuration to the
mcpServers section:Environment Variables
The server requires the following environment variables:
ARANGO_URL- ArangoDB server URL (note: 8529 is the default port for ArangoDB for local development)
ARANGO_DB- Database name
ARANGO_USERNAME- Database user
ARANGO_PASSWORD- Database password
Usage
You can pretty much provide any meaningful prompt and Claude will try to execute the appropriate function.
Some example propmts:
- "List all collections in the database"
- "Query all users"
- "Insert a new document with name 'John Doe' and email "john@example.com' to the 'users' collection"
- "Update the document with key '123456' or name 'Jane Doe' to change the age to 48"
- "Create a new collection named 'products'"
Usage with Claude App
Demo of using ArangoDB MCP server with Claude App
Uasge with Cline VSCode extension
Demo of using ArangoDB MCP server with Cline VSCode extension
Query all users:
Insert a new document:
Update a document:
Remove a document:
List all collections:
Backup database collections:
Create a new collection:
Note: The server is database-structure agnostic and can work with any collection names or structures as long as they follow ArangoDB's document and edge collection models.
Development
- Clone the repository
- Install dependencies:
- For development with auto-rebuild:
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. recommended debugging can be done by using MCP Inspector for development:
The Inspector will provide a URL to access debugging tools in your browser.
License
This project is licensed under the MIT License - see the LICENSE file for details.