适合谁
- 已在使用 Directus 并希望在 LLM 中读写内容的内容团队
- 需要用自然语言查询 Directus 数据的分析师
- 希望为非开发人员提供受控数据访问的 Directus 项目
D
70FMRS · B
官方维护的 Directus 数据 MCP 服务器，工具覆盖面完整（条目、文件、字段、流程、评论、提示），内置防止数据丢失的护栏，适合内容与数据场景；对非 Directus 用户无用，且开发者的破坏性操作被有意限制。
Directus Content MCP Server 是 Directus 官方提供的 MCP 服务器，让用户在大语言模型中与 Directus 数据交互。内容编辑者可构建页面、撰写博客、管理资产；数据分析师可用自然语言查询集合、生成报告和分析趋势。服务器有意限制删除字段或集合等可能导致数据丢失的破坏性操作，并提供系统提示词、动态提示和 Mustache 模板等配置能力。
工具能力
system-prompt
向 LLM 助手提供其角色上下文
users-me
获取当前用户信息
read-collections
获取所有集合的架构
read-items
从任意集合获取条目
create-item
在集合中创建新条目
update-item
修改现有条目
delete-item
从集合中删除条目
read-files
访问文件元数据或原始内容
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
执行已存储的提示
安装接入
前提：拥有一个现有 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"}}}}
选型与风险
不适合谁
- 不使用 Directus 的项目
- 需要对开发环境进行完整破坏性/管理员操作的开发者（删除字段、删除集合等被有意限制）
- 不支持 MCP 的客户端
所需权限
- 需要 Directus 实例 URL 及静态 Token 或邮箱/密码凭据
- MCP 中的操作受该凭据对应 Directus 用户的权限限制
风险与副作用
- 具备创建、更新和删除条目与字段的写入能力，配置错误仍可能造成数据变更
- 凭据泄露会授予 LLM 对 Directus 数据的访问权
- 删除字段、删除集合等操作虽被限制，但删除条目仍可用
常见排障
- 静态 Token 报 Invalid token 时，检查生成 Token 后是否保存了用户
- 确认 DIRECTUS_URL 与凭据正确替换了占位符
- Claude Desktop 修改配置后需重启才能看到 Directus MCP 图标
- Cursor 中在 Settings/MCP 检查服务器是否显示绿色活跃状态
使用场景
内容编辑者构建自定义页面、撰写博客、更新内容、整理资产
数据分析师用自然语言查询集合、生成报告、分析趋势
通过触发自动化流程执行批量操作或状态变更
为 WYSIWYG 字段进行 Markdown 与 HTML 格式转换
支持客户端
Claude Desktop完整支持
Cursor完整支持