🚀 ArangoDB 的 MCP 服务器

这是一个基于 TypeScript 的 MCP 服务器，借助 MCP 工具实现了与 ArangoDB 数据库的交互。它不仅实现了核心数据库操作，还支持与 ArangoDB 的无缝集成。该服务器可用于 Claude 应用，也适用于与 Cline 配合使用的 VSCode 扩展！

✨ 主要特性

工具

• arango_query - 执行 AQL 查询

  • 需传入 AQL 查询字符串作为必填参数。
  • 可选择传入绑定变量，以支持参数化查询。
  • 查询结果以 JSON 格式返回。

• arango_insert - 向集合中插入文档

  • 需传入集合名称和文档对象作为必填参数。
  • 若未提供文档键，系统将自动生成。
  • 返回创建的文档元数据。

• arango_update - 更新现有文档

  • 需传入集合名称、文档键和更新对象作为必填参数。
  • 返回更新后的文档元数据。

• arango_remove - 从集合中删除文档

  • 需传入集合名称和文档键作为必填参数。
  • 返回被删除的文档元数据。

• arango_backup - 备份所有集合到 JSON 文件

  • 需传入输出目录路径作为必填参数。
  • 为每个集合创建 JSON 文件，并保存当前数据。
  • 适用于数据备份和迁移。

• arango_list_collections - 列出数据库中的所有集合

  • 返回包含名称、ID 和类型的集合信息数组。

🔧 技术细节

该服务器不依赖于特定的数据库结构，只要遵循 ArangoDB 文档集和边文档模型即可工作。

📦 安装指南

开发依赖安装

npm run build

带有自动重建功能的开发

npm run watch

与 Claude 桌面应用配合使用

在 mcpServers 部分添加服务器配置：

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

与 Cline VSCode 扩展配合使用

在 mcpServers 部分添加以下配置：

• MacOS: ~/Library/Application Support/Code/User/globalStorage/cline.cline/config.json
• Windows: %APPDATA%/Code/User/globalStorage/cline.cline/config.json

{
  "servers": {
    "arangoMCP Server": {
      "executablePath": "/path/to/arango_mcp_server",
      "schemaVersion": "0.9.3"
    }
  }
}

🚀 快速开始

由于 MCP 服务器通过标准输入输出进行通信，调试可能具有挑战性。我们建议使用 MCP Inspector 进行开发：

npm run inspector

Inspector 将提供一个 URL，以便您在浏览器中访问调试工具。

📄 许可证

该项目根据 MIT 许可证发布 - 有关详细信息，请参阅 LICENSE 文件。