D

Directus模型协议服务器

@rijkvanzanten/directus-mcp-server
0 Stars 23 次浏览 rijkvanzanten 更新于 2026-08-23

一种模型上下文协议服务器,允许人工智能工具连接到您的Directus API并与其交互,从而实现对集合、项目和用户数据的自动化访问。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "directus": {
      "command": "directus-mcp-server",
      "env": {
        "DIRECTUS_TOKEN": "\u003cyour Directus user token\u003e",
        "DIRECTUS_URL": "\u003cyour Directus instance URL\u003e"
      }
    }
  }
}

该服务需要配置环境变量:DIRECTUS_TOKEN、DIRECTUS_URL

服务介绍

Directus Model Context Protocol (MCP) 服务器

用于与 Directus 配合使用的 MCP 服务器。允许您的 AI 工具代表您连接并使用您的 Directus API。

这是由本人(@rijkvanzanten)进行的一个实验。欢迎提交任何和所有的 PR :)

安装

此 MCP 服务器设计为与 NodeJS v22.12 或更新版本一起工作。

全局安装(推荐)

npm install -g @rijk/directus-mcp-server

然后配置 Claude AI 使用 npm 包作为远程服务器:

{
    "mcpServers": {
        "directus": {
            "command": "directus-mcp-server",
            "env": {
                "DIRECTUS_URL": "<your Directus instance URL>",
                "DIRECTUS_TOKEN": "<your Directus user token>"
            }
        }
    }
}

本地/开发安装

  1. 克隆仓库
  2. 运行 pnpm install && pnpm build 来构建服务器
  3. 按照上述方法配置 Claude AI,但指向 dist 文件而不是:
{
    "mcpServers": {
        "directus": {
            "command": "node",
            "args": ["/path/to/directus-mcp-server/dist/index.js"]
        }
    }
}

工具

读取项目

read-items 工具允许您通过提供集合名称作为参数来从任何 Directus 集合中读取项目。

参数:

  • collection: (必填)要从中读取的集合名称
  • fields: (可选)要返回的字段名称数组
  • sort: (可选)排序依据的字段(以 - 开头表示降序)
  • limit: (可选)最大返回项数

示例:

{
  "collection": "articles",
  "fields": ["id", "title", "date_published"],
  "sort": "-date_published",
  "limit": 10
}

读取当前用户

获取关于当前用户的信息。实际上等同于 /users/me 端点。

读取集合

返回系统中可用的集合/字段。在使用 read-items 工具之前,请先使用此工具发现可用的集合。

许可证

MIT

相关 MCP 服务