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" } } } }
对于光标：
1. 前往“设置”→“光标设置”→“MCP”
2. 点击+ Add New Global MCP Server
3. 粘贴配置
4. 使用您的 Directus 凭证替换占位符值
5. 保存并重新启动Cursor
对于 Claude 桌面：
1. 打开“设置”→“开发者”
2. 单击Edit Config
3. 在代码编辑器中打开claude_desktop_config.json并粘贴配置
4. 使用您的 Directus 凭证替换占位符值
5. 保存并重新启动Claude

❓ 故障排除

如果您在 MCP 客户端（例如 Cursor 或 Claude Desktop）中启动服务器时遇到问题，请尝试以下操作。

确保您拥有有效的 Directus 凭证

验证您的 Directus URL 是否正确且可访问
检查您的访问令牌或电子邮件/密码凭证是否有效
替换 MCP 客户端配置中的凭据
保存并重启MCP 客户端

确保已安装 Node 和 NPM

运行以下命令确认您已安装 Node 和 NPM：

node -v
npm -v

清除 NPM 缓存

有时清除NPM 缓存可以解决npx的问题。

npm cache clean --force

🛠️ 可用工具

收藏品和物品

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
启动开发服务器：
npm run dev

Directus MCP Server