Directus MCP 服务器

一个为 Directus CMS 实现模型上下文协议 (MCP) 的 Node.js 服务器。允许 AI 客户端通过模型上下文协议 (MCP) 与Directus API进行交互。

ℹ 先决条件

• Node.js

• 新公共管理

• Directus 实例

▶️ 快速入门

1. 获取您的 Directus API 凭证

   • 转到您的 Directus 实例

   • 创建静态访问令牌或获取您的电子邮件和密码

   • 确保这些凭证的安全

2. 添加到您的 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 凭证

1. 验证您的 Directus URL 是否正确且可访问

2. 检查您的访问令牌或电子邮件/密码凭证是否有效

3. 替换 MCP 客户端配置中的凭据

4. 保存并重启MCP 客户端

确保已安装 Node 和 NPM

• Node.js

• 新公共管理

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

清除 NPM 缓存

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

🛠️ 可用工具

收藏品和物品

文件

用户和权限

系统

🚧 开发模式

如果您想以开发模式运行服务器：

1. 克隆并安装：

   git clone https://github.com/pixelsock/directus-mcp.git cd directus-mcp npm install

2. 将您的凭证添加到.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

3. 启动开发服务器：

   npm run dev

📄 Directus 开发者资源

• Directus API 文档

• Directus API 端点

• Directus JavaScript SDK