arangodb/mcp-arangodb

镜像概述

arangodb/mcp-arangodb是一个Docker镜像，提供Model Context Protocol（MCP）服务器，用于连接AI助手（如Cursor、Claude等MCP兼容环境）与ArangoDB数据库，实现AI辅助的数据库工作流。

核心功能

主要能力

• 执行AQL查询
• 探索集合、图和索引
• 将结构化结果集成到LLM提示中
• 基于ArangoDB数据的AI辅助工作流

关键特性

• 内置AQL手册和优化指南
• 从现有数据库集合发现schema
• 支持绑定变量的AQL生成与执行
• Docker部署确保环境一致性
• 安全的环境变量配置

可用MCP工具

使用场景

• AI辅助的AQL查询生成与执行
• 数据库结构探索与schema分析
• 自动化数据采样与结果提取
• 集成AI工具（如Cursor）进行数据库操作

配置说明

前提条件

使用前需确保：

• Docker已安装并运行
• ArangoDB实例（版本3.11+）
• Cursor IDE或其他MCP兼容客户端

部署步骤

1. 启动ArangoDB（示例）

bash
docker run -d --name arangodb \
  -p 8529:8529 \
  -e ARANGO_ROOT_PASSWORD=test \
  docker.xuanyuan.run/arangodb:latest

2. 拉取MCP镜像

bash
docker pull docker.xuanyuan.run/arangodb/mcp-arangodb:latest

3. 运行MCP容器（可选，测试用）

注意：此步骤可选，配置Cursor时会自动启动容器，手动运行用于测试连接和调试。

bash
docker run -i --rm --network host \
  -e ARANGO_HOSTS=http://localhost:8529 \
  -e ARANGO_ROOT_USERNAME=root \
  -e ARANGO_ROOT_PASSWORD=test \
  -e ARANGO_DEFAULT_DB_NAME=_system \
  docker.xuanyuan.run/arangodb/mcp-arangodb:latest

4. 配置Cursor

在工作区.cursor/mcp.json或全局~/.cursor/mcp.json中添加：

json
{
  "mcpServers": {
    "arangodb-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--network", "host",
        "-e", "ARANGO_HOSTS=http://localhost:8529",
        "-e", "ARANGO_ROOT_USERNAME=root",
        "-e", "ARANGO_ROOT_PASSWORD=test",
        "-e", "ARANGO_DEFAULT_DB_NAME=_system",
        "arangodb/mcp-arangodb:latest"
      ]
    }
  }
}

5. 验证连接

重启Cursor后，在"Tools & MCP"视图查看"arangodb-mcp"是否连接，可通过测试简单查询（如"列出users集合中的5个文档"）验证功能。

环境变量配置

HTTPS生产环境配置示例

bash
docker run -i --rm --network host \
  -v /path/to/certs:/certs:ro \
  -e ARANGO_HOSTS=https://localhost:8530 \
  -e ARANGO_ROOT_USERNAME=root \
  -e ARANGO_ROOT_PASSWORD=your_password \
  -e ARANGO_DEFAULT_DB_NAME=production_db \
  -e ARANGO_VERIFY_SSL=true \
  -e ARANGO_SSL_CERT_PATH=/certs/arango-ca.pem \
  docker.xuanyuan.run/arangodb/mcp-arangodb:latest

调试

若Cursor显示"No tools..."，检查容器日志：

bash
docker logs <container-name>

常见问题：密码错误、ArangoDB未运行、网络连接问题、环境变量缺失等。

许可证

MCP服务器遵循MIT许可证，其他依赖项遵循各自许可证。 ===END===