Ravenwits_mcp Server Arangodb

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

  • 0 关注
  • 0 收藏,11 浏览
  • system 提出于 2025-09-24 23:42

相似服务问题