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 文件。