# mcp-server-arangodb

> MCP Server

This TypeScript-based MCP server provides ArangoDB interaction, offering tools for querying, inserting, updating, removing, backing up, listing, and creating collections, enabling seamless database operations and integration with MCP tools.

## Overview

- **Category:** Database
- **Language:** TypeScript
- **Stars:** 47
- **Forks:** 3
- **Owner:** ravenwits
- **GitHub:** https://github.com/ravenwits/mcp-server-arangodb
- **Created:** 2024-12-28T19:08:48+00:00
- **Updated:** 2025-03-21T13:41:39+00:00
- **Source:** https://model-context-protocol.com/servers/typescript-mcp-server-arangodb-database-interaction

## Setup

## Setup

**Installing via Smithery**:

To install ArangoDB for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ravenwits/mcp-server-arangodb):

```bash
npx -y @smithery/cli install @ravenwits/mcp-server-arangodb --client claude
```

To use with Claude Desktop, add the server config:

- MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%/Claude/claude_desktop_config.json`

To use with Cline VSCode Extension, add the server config:

- 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:

```json
{
  "mcpServers": {
    "arango": {
      "command": "node",
      "args": ["/path/to/arango-server/build/index.js"],
      "env": {
        "ARANGO_URL": "your_database_url",
        "ARANGO_DATABASE": "your_database_name",
        "ARANGO_USERNAME": "your_username",
        "ARANGO_PASSWORD": "your_password"
      }
    }
  }
}
```

**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_DATABASE` - Database name
- `ARANGO_USERNAME` - Database user
- `ARANGO_PASSWORD` - Database password

## Tools

## Available Tools

1.  `arango_query` - Execute AQL queries.
2.  `arango_insert` - Insert documents into collections.
3.  `arango_update` - Update existing documents.
4.  `arango_remove` - Remove documents from collections.
5.  `arango_backup` - Backup all collections to JSON files.
6.  `arango_list_collections` - List all collections in the database.
7.  `arango_create_collection` - Create a new collection in the database.