mcpField
A
ArangoDB MCP Server

ArangoDB MCP Server

本地服务
github.com/lucas-deangelis数据库479 周前更新
代码仓库

关于 ArangoDB MCP Server

ArangoDB MCP Server 将 MCP 客户端连接到 ArangoDB，提供数据库和集合列表查询及 AQL 执行，并区分只读与读写查询。

主要功能

  1. 01执行只读 AQL 查询
  2. 02执行读写 AQL 查询
  3. 03列出数据库
  4. 04列出数据库集合

适用场景

  1. 01查看查询结果而不修改数据
  2. 02运行会修改数据的 AQL 查询
  3. 03发现 ArangoDB 服务中的数据库
  4. 04查找指定数据库中的集合

MCP 相关

通过 MCP 工具执行 ArangoDB 查询，并列出数据库和集合。项目还记录了按数据库、集合和 ID 读取文档的资源模板。

#arango#database#mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "arango": {
      "command": "npx",
      "args": [
        "-y",
        "arango-mcp-server"
      ]
    }
  }
}
启动命令npx -y arango-mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmarango-mcp-server

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

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）
  • 客户端池，即每个数据库一个客户端
  • 开发环境
  • 使用模板通过数据库名称、集合和 id 读取任意文档的 resources/read
  • 将用户名和密码添加为命令参数

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。