Ravenwits MCP Server Arangodb

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