Directus MCP

🚀 Directus MCP 服务器

本项目是一个基于 Node.js 的服务器，实现了模型上下文协议（MCP）与 Directus CMS 的集成。它允许 AI 客户端通过 Model Context Protocol (MCP) 交互式地访问 Directus API。

🚀 快速开始

先决条件

• Node.js
• NPM
• 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"
         }
       }
     }
   }
   

✨ 主要特性

以下是服务器提供的部分功能列表：

• 数据管理：创建、读取、更新和删除数据记录。
• API 调用：执行自定义 API 请求。
• 系统信息：获取服务器状态和配置详情。
• 日志查看：检索活动日志和错误信息。

🚧 开发模式

若需以开发模式运行服务器，可按以下步骤操作：

克隆代码并安装依赖

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
# 或使用邮箱/密码
DIRECTUS_EMAIL=your-email@example.com
DIRECTUS_PASSWORD=your-password

启动开发服务器

npm run dev

🚨 故障排除

如果遇到问题，请检查以下内容：

• 确保 Directus 实例正常运行。
• 检查网络连接，确保可以访问 Directus API。
• 确认凭据的正确性。

如仍有问题，请参考 Directus 文档 或联系支持团队。

📚 详细文档

Directus 开发资源

• Directus API 文档
• Directus API 端点
• Directus JavaScript SDK 指南