← 返回目录

Directus Content MCP Server

官方

在 LLM 中直接与 Directus 数据交互的内容服务器。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 数据库第 8 / 58
Stars: ★ 86 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 17 个月前 ⚠
工具数: 21

70FMRS · B

官方维护的 Directus 数据 MCP 服务器，工具覆盖面完整（条目、文件、字段、流程、评论、提示），内置防止数据丢失的护栏，适合内容与数据场景；对非 Directus 用户无用，且开发者的破坏性操作被有意限制。

最强项 · 文档质量 18/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

15/20

维护活跃度

12/20

文档质量

18/20

安装易用性

15/20

查看各项评分依据

可靠性 10/20: MCP服务器提供了丰富的工具集，但作为静态审查，我们无法验证实际运行情况。代码库结构清晰，但缺乏可见的测试用例和CI/CD流程证据。工具声明与README描述一致，但错误处理机制无法评估。
安全与权限 15/20: 服务器支持令牌和密码认证，提供了环境变量配置选项。故意限制了破坏性操作，如删除字段或集合。没有发现明显的安全漏洞，但无法完全验证所有边界情况下的安全性。
维护活跃度 12/20: 项目有83个星标和13个开放问题，表明有一定社区参与。MIT许可证清晰可见。但提交历史和发布频率无法从静态审查中确定，依赖项更新情况未知。
文档质量 18/20: README非常详细，提供了安装、配置和使用说明。包含多个配置示例，支持不同场景。工具表清晰列出了所有可用工具及其用途。系统提示配置和Mustache模板功能文档完整。
安装易用性 15/20: 安装步骤清晰明确，支持多种AI工具（Claude Desktop、Cursor）。提供了生产环境和开发环境的配置示例。环境变量配置选项全面，易于设置。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络修改第三方账户数据连接数据库

适合谁

已在使用 Directus 并希望在 LLM 中读写内容的内容团队
需要用自然语言查询 Directus 数据的分析师
希望为非开发人员提供受控数据访问的 Directus 项目

不适合谁

不使用 Directus 的项目
需要对开发环境进行完整破坏性/管理员操作的开发者（删除字段、删除集合等被有意限制）
不支持 MCP 的客户端

所需权限

需要 Directus 实例 URL 及静态 Token 或邮箱/密码凭据
MCP 中的操作受该凭据对应 Directus 用户的权限限制

风险与副作用

具备创建、更新和删除条目与字段的写入能力，配置错误仍可能造成数据变更
凭据泄露会授予 LLM 对 Directus 数据的访问权
删除字段、删除集合等操作虽被限制，但删除条目仍可用

安装接入

准备工作

运行环境：Node.js

DIRECTUS_URL 必填你的 Directus 实例地址，例如 https://your-directus-url.com，必填。

DIRECTUS_TOKEN 可选密钥在 Directus 用户目录中自己账户的 Token 字段生成的静态访问令牌，与邮箱/密码二选一。

DIRECTUS_USER_PASSWORD 可选密钥登录 Directus 的密码，与 DIRECTUS_USER_EMAIL 配合使用。

其他可选配置项（10 个）

DIRECTUS_USER_EMAIL 可选登录 Directus 的邮箱，配合密码作为令牌的替代认证方式。

MCP_SYSTEM_PROMPT 可选覆盖服务器默认系统提示词的自定义文本，可选。

MCP_SYSTEM_PROMPT_ENABLED 可选设为 false 可完全禁用系统提示词，可选。

DISABLE_TOOLS 可选要禁用的工具名称数组，如 ["delete-item", "update-field"]，可选。

DIRECTUS_PROMPTS_COLLECTION_ENABLED 可选设为 "true" 以启用存储在 Directus 集合中的动态提示词功能。

DIRECTUS_PROMPTS_COLLECTION 可选存放提示词的集合名称，例如 ai_prompts。

DIRECTUS_PROMPTS_NAME_FIELD 可选提示词名称字段名，默认为 name。

DIRECTUS_PROMPTS_DESCRIPTION_FIELD 可选提示词描述字段名，默认为 description。

DIRECTUS_PROMPTS_SYSTEM_PROMPT_FIELD 可选系统提示词文本字段名，默认为 system_prompt。

DIRECTUS_PROMPTS_MESSAGES_FIELD 可选消息数组的字段名，默认为 messages。

前提：拥有一个现有 Directus 项目（可使用 Directus Cloud 免费试用，或运行 npx directus-template-cli@latest init 本地创建）。第一步：获取凭据——可在用户目录的个人资料中生成静态 Token（务必保存用户），或使用邮箱和密码。第二步：在 Claude Desktop 或 Cursor 的 MCP 配置中添加服务器，命令为 npx @directus/content-mcp@latest，环境变量包括 DIRECTUS_URL 和 DIRECTUS_TOKEN（或 DIRECTUS_USER_EMAIL / DIRECTUS_USER_PASSWORD），保存后重启客户端。本地开发：克隆仓库后运行 pnpm install && pnpm build，配置指向 dist/index.js，可用 pnpm dev 监听变更。

claude_desktop_config.json

{"mcpServers":{"directus":{"command":"npx","args":["@directus/content-mcp@latest"],"env":{"DIRECTUS_URL":"https://your-directus-url.com","DIRECTUS_TOKEN":"your-directus-token"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "directus": {
      "command": "npx",
      "args": [
        "@directus/content-mcp@latest"
      ],
      "env": {
        "DIRECTUS_URL": "https://your-directus-url.com",
        "DIRECTUS_TOKEN": "your-directus-token"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add directus -e DIRECTUS_URL=https://your-directus-url.com -e DIRECTUS_TOKEN=your-directus-token -- npx @directus/content-mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

配置客户端并重启后，确认 Directus MCP 服务器显示已连接（Cursor 中为绿色状态，Claude Desktop 中出现服务器图标），然后让它执行 read-collections 或 users-me；成功返回即证明凭据有效。

常见排障

静态 Token 报 Invalid token 时，检查生成 Token 后是否保存了用户
确认 DIRECTUS_URL 与凭据正确替换了占位符
Claude Desktop 修改配置后需重启才能看到 Directus MCP 图标
Cursor 中在 Settings/MCP 检查服务器是否显示绿色活跃状态

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我的 Directus 实例中的所有集合并描述它们的 schema。
从 posts 集合中获取最新的 10 条数据。
在 posts 集合中创建一篇标题为“上线说明”的博客草稿。
把这个 URL 的图片导入到我的 Directus 文件库。

工具能力 21

system-prompt 只读

向 LLM 助手提供其角色上下文

users-me 只读

获取当前用户信息

read-collections 只读

获取所有集合的架构

read-items 只读

从任意集合获取条目

create-item 写入

在集合中创建新条目

update-item 写入

修改现有条目

delete-item 破坏性

从集合中删除条目

read-files 只读

访问文件元数据或原始内容

展开其余 13 个工具

import-file 写入

从 URL 导入文件

update-files 写入

更新文件元数据

read-fields 只读

获取集合的字段定义

read-field 只读

获取特定字段信息

create-field 写入

为集合添加新字段

update-field 写入

修改现有字段

read-flows 只读

列出可用的自动化流程

trigger-flow 写入

执行自动化流程

read-comments 只读

查看条目上的评论

upsert-comment 写入

添加或更新评论

markdown-tool 只读

在 Markdown 和 HTML 之间转换

get-prompts 只读

列出可用的提示模板

get-prompt 只读

执行已存储的提示

使用场景

内容编辑者构建自定义页面、撰写博客、更新内容、整理资产

数据分析师用自然语言查询集合、生成报告、分析趋势

通过触发自动化流程执行批量操作或状态变更

为 WYSIWYG 字段进行 Markdown 与 HTML 格式转换

支持客户端

Claude Desktop

Cursor

依据项目文档列出，未经本站实测。

详细介绍

Directus Content MCP Server 是 Directus 官方提供的 MCP 服务器，让用户在大语言模型中与 Directus 数据交互。内容编辑者可构建页面、撰写博客、管理资产；数据分析师可用自然语言查询集合、生成报告和分析趋势。服务器有意限制删除字段或集合等可能导致数据丢失的破坏性操作，并提供系统提示词、动态提示和 Mustache 模板等配置能力。