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/ 查看检查器。

待办事项

• [ ] 适当研究规范，看看当前资源的实现是否真的有意义（我认为没有）
  • [x] 资源模板有意义
• [ ] 将所有 "arango" 更改为 "arangodb" (包括 repo 名称...)
• [ ] 添加回 ArangoDB 密码
• [ ] 适当的 README
  • [ ] 遵循官方 Anthropic 格式的工具/资源/等
• [ ] 弄清楚通知
• [ ] 健康检查
• [ ] 更多工具？
• [ ] 访问在 ArangoDB 实例上运行的所有数据库
• [ ] 以某种方式在 npm 上发布，以便可以使用 npx
• [ ] resources/subscribe 和 notifications/resources/list_changed 和 resources/unsubscribe
• [x] 在 README 中正确记录工具
• [x] 就像在 SQLite MCP 客户端上一样
  • [x] write_query 工具与 read_query 分离 -> 实际上是 readWriteQuery
  • [x] list_collections (参见 list_tables)
• [x] 客户端池，即每个数据库一个客户端
• [x] 开发环境
• [x] resources/read，带有一个模板，用于按数据库名称、集合、ID 读取任何文档。
• [x] 将用户名和密码添加为命令的参数