ArangoDB MCP 服务器

这是为 ArangoDB 实现的模型上下文协议。

概览

待填写。

组件

资源

工具

查询工具

• readQuery
  • 在数据库上执行只读查询
  • 输入：
    • databaseName (字符串): 要查询的数据库
    • aql (字符串): 要执行的只读 AQL 查询
  • 返回: 作为对象数组的查询结果
• readWriteQuery
  • 在数据库上执行查询
  • 输入：
    • databaseName (字符串): 要查询的数据库
    • aql (字符串): 要执行的 AQL 查询
  • 返回: 作为对象数组的查询结果
• listDatabases
  • 列出 ArangoDB 服务器上的所有数据库
  • 返回: 数据库名称数组
• listCollections
  • 列出 ArangoDB 数据库中的所有集合
  • 输入：
    • databaseName (字符串): 数据库的名称
  • 返回: 对象数组 { "name": "<collectionName>" }

使用方法

要连接到运行在 localhost:2434 上的 arangodb 实例，并连接到 "account" 数据库，请将以下内容添加到您的 claude_desktop_config.json 中，假设此项目的路径为 /home/yourcoolname/arango-mcp-server：

{
  "mcpServers": {
    "arangodb-account": {
      "command": "npx",
      "args": [
        "-y",
        "arango-mcp-server",
        "http://localhost:8529",
        "root",
        "root"
      ]
    }
  }
}

开发

克隆仓库。
安装所有依赖。
设置开发环境。
运行监视器。
编辑 index.ts。

$ npm install
$ npm run dev:setup
$ npm run dev

前往 http://localhost:5173/ 查看检查器。

待办事项

• 仔细研究规范，看看当前资源实现是否合理（我认为不合理）
  • 资源模板是有意义的
• 将所有的 "arango" 更改为 "arangodb"（包括仓库名...）
• 添加回 arangodb 密码
• 完整的 README
  • 工具/资源等按照官方 Anthropic 格式编写
• 弄清楚通知机制
• 健康检查
• 更多工具？
• 访问 arangodb 实例上运行的所有数据库
• 以某种方式发布到 npm，以便可以使用 npx
• resources/subscribe 和 notifications/resources/list_changed 和 resources/unsubscribe
• 在 README 中适当记录工具
• 类似于 SQLite MCP 客户端
  • write_query 工具与 read_query 分开 -> 实际上是 readWriteQuery
  • list_collections（参见 list_tables）
• 客户端池，即每个数据库一个客户端
• 开发环境
• resources/read 以及通过数据库名称、集合和 ID 读取任何文档的模板
• 将用户名和密码作为命令参数添加