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 指南