ArangoDB MCP 服务器

“ArangoDB” MCP 服务器能做什么？

ArangoDB MCP 服务器是一个基于 TypeScript 的模型上下文协议（MCP）服务器，为 ArangoDB 提供无缝数据库交互能力。它作为 AI 助手与 ArangoDB 数据库之间的强大桥梁，使开发者和基于大模型的代理能够通过标准化 MCP 工具直接执行核心数据库操作。该服务器支持数据查询、文档插入和更新、集合管理、备份等任务，全部通过简单的工具调用完成。它可集成到如 Claude、VSCode（通过 Cline 等插件）等平台，是需要实时或以编程方式访问结构化数据的开发流程中的多功能后端。

提示词列表

仓库中未特别提及任何提示词模板。

资源列表

仓库文档中未明确描述任何 MCP 资源。

工具列表

• arango_query
  执行 AQL（ArangoDB 查询语言）查询。接受查询字符串和可选绑定变量，返回 JSON 格式的查询结果。

• arango_insert
  向集合中插入文档。需指定集合名和文档对象，如果未提供文档 key，则自动生成。

• arango_update
  更新集合中的已有文档。需提供集合名、文档 key 及更新对象。

• arango_remove
  从集合中删除文档。需提供集合名和文档 key。

• arango_backup
  将所有集合备份为指定目录中的 JSON 文件，适用于数据迁移和备份。

• arango_list_collections
  列出数据库中的所有集合，返回它们的名称、ID 和类型。

• arango_create_collection
  创建新集合（文档或边类型），可指定名称、类型和同步行为等选项。

此 MCP 服务器的应用场景

• 数据库管理
  直接通过 AI 工具或聊天代理轻松对 ArangoDB 集合进行 CRUD（增删改查）操作。

• 面向数据项目的代码库探索
  让开发者无需离开开发环境即可查询和修改应用数据，简化数据探索流程。

• 自动化数据备份与迁移
  使用备份工具将集合数据导出为 JSON，支持自动备份流程并便于迁移。

• 与 AI 代理集成
  让大模型及 AI 助手（如 Claude 或 VSCode+Cline 等）可在代理流程中获取、更新或分析数据库数据。

• 动态集合管理
  允许以编程方式创建和列出集合，支持快速原型开发或多租户应用。

如何搭建

Windsurf

未提供 Windsurf 的搭建说明。

Claude

未提供 Claude 的搭建说明。

Cursor

未提供 Cursor 的搭建说明。

Cline（VSCode 插件）

1. 前置条件：确保已安装 VSCode（版本 1.99.0 及以上）。
2. 编辑/创建 MCP 配置：
   • 工作区：.vscode/mcp.json
   • 用户：可添加到 VSCode 用户设置实现全局使用。
3. 添加 ArangoDB MCP 服务器配置：

   {
     "servers": {
       "arango-mcp": {
         "type": "stdio",
         "command": "npx",
         "args": ["arango-server"],
         "env": {
           "ARANGO_URL": "http://localhost:8529",
           "ARANGO_DB": "v20",
           "ARANGO_USERNAME": "app",
           "ARANGO_PASSWORD": "75Sab@MYa3Dj8Fc"
         }
       }
     }
   }
   

4. 启动 MCP 服务器：
   • 打开命令面板（Windows：Ctrl+Shift+P，Mac：Cmd+Shift+P）
   • 执行 MCP: Start Server 并选择 arango-mcp。

API 密钥安全

建议使用环境变量存储凭据。示例：

{
  "servers": {
    "arango-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["arango-server"],
      "env": {
        "ARANGO_URL": "${env:ARANGO_URL}",
        "ARANGO_DB": "${env:ARANGO_DB}",
        "ARANGO_USERNAME": "${env:ARANGO_USERNAME}",
        "ARANGO_PASSWORD": "${env:ARANGO_PASSWORD}"
      }
    }
  }
}

在流程中如何使用 MCP

在 FlowHunt 中使用 MCP

要将 MCP 服务器集成到 FlowHunt 工作流中，请首先将 MCP 组件添加到流程，并连接到您的 AI 代理：

点击 MCP 组件打开配置面板。在系统 MCP 配置区，按如下 JSON 格式填写 MCP 服务器信息：

{
  "arango-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI 代理即可作为工具使用该 MCP，具备访问其所有功能和能力。请记得将 “arango-mcp” 替换为实际 MCP 服务器名称，URL 替换为你自己的 MCP 服务器地址。

概览

我们的看法

该 MCP 服务器在工具支持和搭建文档方面表现良好，特别适合 VSCode/Cline 用户。但缺少明确的提示词模板、资源描述，也未提及采样或根支持。其主要优点在于数据库工具齐全、环境变量处理明晰。
综合来看，我们为其实用性和文档评分 7/10，但在高级 MCP 特性上尚有不足。

MCP 评分