Directus MCP 服务器
一个为 Directus CMS 实现模型上下文协议 (MCP) 的 Node.js 服务器。允许 AI 客户端通过模型上下文协议 (MCP) 与Directus API进行交互。
ℹ 先决条件
▶️ 快速入门
- 获取您的 Directus API 凭证
- 转到您的 Directus 实例
- 创建静态访问令牌或获取您的电子邮件和密码
- 确保这些凭证的安全
- 添加到您的 AI 编辑器
{
"mcpServers": {
"directus": {
"command": "npx",
"args": ["-y", "@pixelsock/directus-mcp@latest"],
"env": {
"DIRECTUS_URL": "https://your-directus-instance.com",
"DIRECTUS_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN"
}
}
}
}
{
"mcpServers": {
"directus": {
"command": "npx",
"args": ["-y", "@pixelsock/directus-mcp@latest"],
"env": {
"DIRECTUS_URL": "https://your-directus-instance.com",
"DIRECTUS_EMAIL": "your-email@example.com",
"DIRECTUS_PASSWORD": "your-password"
}
}
}
}
- 前往“设置”→“光标设置”→“MCP”
- 点击
+ Add New Global MCP Server - 粘贴配置
- 使用您的 Directus 凭证替换占位符值
- 保存并重新启动Cursor
对于 Claude 桌面：
- 打开“设置”→“开发者”
- 单击
Edit Config - 在代码编辑器中打开
claude_desktop_config.json并粘贴配置 - 使用您的 Directus 凭证替换占位符值
- 保存并重新启动Claude
❓ 故障排除
如果您在 MCP 客户端（例如 Cursor 或 Claude Desktop）中启动服务器时遇到问题，请尝试以下操作。
确保您拥有有效的 Directus 凭证
- 验证您的 Directus URL 是否正确且可访问
- 检查您的访问令牌或电子邮件/密码凭证是否有效
- 替换 MCP 客户端配置中的凭据
- 保存并重启MCP 客户端
确保已安装 Node 和 NPM
运行以下命令确认您已安装 Node 和 NPM：
清除 NPM 缓存
有时清除NPM 缓存可以解决npx的问题。
🛠️ 可用工具
收藏品和物品
getItems // Get items from a collection
getItem // Get a single item from a collection by ID
createItem // Create a new item in a collection
updateItem // Update an existing item in a collection
deleteItem // Delete an item from a collection
getCollections // Get all collection schemas
getFields // Get fields for a collection
getRelations // Get relations for a collection
文件
getFiles // Get files from Directus
uploadFile // Upload a file to Directus
用户和权限
login // Login to Directus and get an access token
getUsers // Get users from Directus
getCurrentUser // Get the current user info
getRoles // Get roles from Directus
getPermissions // Get permissions from Directus
系统
getSystemInfo // Get system information from Directus
getActivity // Get activity logs from Directus
getConfig // Get current configuration information
🚧 开发模式
如果您想以开发模式运行服务器：
- 克隆并安装：
git clone https://github.com/pixelsock/directus-mcp.git
cd directus-mcp
npm install
- 将您的凭证添加到
.env ：# .env
DIRECTUS_URL=https://your-directus-instance.com
DIRECTUS_ACCESS_TOKEN=your_token_here
# Or use email/password
DIRECTUS_EMAIL=your-email@example.com
DIRECTUS_PASSWORD=your-password
- 启动开发服务器：
📄 Directus 开发者资源