MCP Server for ArangoDB

MCP Server for ArangoDB

site icon
2025.04.11 15
TypeScript数据库服务数据管理数据库
mcp-server-arangodb 是一个基于 TypeScript 的 MCP 服务器,专门为 ArangoDB 数据库提供交互能力。它实现了核心的数据库操作功能,并允许通过 MCP 工具与 ArangoDB 无缝集成。该服务器可以与 Claude 应用和 VSCode 的 Cline 扩展一起使用。
View on GitHub

Overview

基本能力

产品定位

mcp-server-arangodb 是一个数据库交互服务,专门为 ArangoDB 提供 MCP 协议支持,使得开发者可以通过 MCP 工具方便地进行数据库操作。

核心功能

  • 数据库查询:支持执行 AQL 查询,返回 JSON 格式的结果。
  • 文档操作:支持插入、更新、删除文档,并返回操作后的文档元数据。
  • 数据备份:支持将数据库中的集合备份为 JSON 文件,便于数据迁移和备份。
  • 集合管理:支持列出所有集合、创建新集合等功能。

适用场景

  • 需要与 ArangoDB 数据库交互的应用开发。
  • 数据库备份和迁移任务。
  • 通过 MCP 工具(如 Claude 或 Cline)进行数据库操作的场景。

工具列表

  • arango_query:执行 AQL 查询。
  • arango_insert:插入文档到集合中。
  • arango_update:更新集合中的文档。
  • arango_remove:从集合中删除文档。
  • arango_backup:备份所有集合到 JSON 文件。
  • arango_list_collections:列出数据库中的所有集合。
  • arango_create_collection:创建新集合。

常见问题解答

  • 调试困难:建议使用 MCP Inspector 进行开发调试。
  • 环境变量配置:必须配置 ARANGO_URLARANGO_DATABASEARANGO_USERNAMEARANGO_PASSWORD 才能正常使用。

使用教程

使用依赖

安装依赖:

npm run build

开发时自动重建:

npm run watch

安装教程

通过 Smithery 安装:

npx -y @smithery/cli install @ravenwits/mcp-server-arangodb --client claude

配置 Claude Desktop 或 Cline VSCode 扩展的服务器配置。

调试方式

使用 MCP Inspector 进行调试:

npm run inspector

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。