Directus MCP Server

Node.js сервер, реализующий протокол Model Context Protocol (MCP) для Directus CMS. Позволяет AI-клиентам взаимодействовать с Directus API через протокол Model Context Protocol (MCP).

ℹ Предварительные требования

• Node.js

• NPM

• Экземпляр Directus

Related MCP server: Node Omnibus MCP Server

▶️ Быстрый старт

1. Получите учетные данные API Directus

   • Перейдите к вашему экземпляру Directus

   • Создайте статический токен доступа или получите свой email и пароль

   • Храните эти учетные данные в безопасности

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"
         }
       }
     }
   }

   Альтернативно, вы можете использовать аутентификацию по email/паролю:

   {
     "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"
         }
       }
     }
   }

   Для Cursor:

   1. Перейдите в Settings → Cursor Settings → MCP

   2. Нажмите + Add New Global MCP Server

   3. Вставьте конфигурацию

   4. Замените значения-заполнители на ваши учетные данные Directus

   5. Сохраните и перезапустите Cursor

   Для Claude Desktop:

   1. Откройте Settings → Developer

   2. Нажмите Edit Config

   3. Откройте claude_desktop_config.json в редакторе кода и вставьте конфигурацию

   4. Замените значения-заполнители на ваши учетные данные Directus

   5. Сохраните и перезапустите Claude

❓ Устранение неполадок

Если у вас возникли проблемы с запуском сервера в вашем MCP-клиенте, например, Cursor или Claude Desktop, попробуйте следующее.

Убедитесь, что у вас есть действительные учетные данные Directus

1. Проверьте, что ваш URL Directus правильный и доступен

2. Проверьте, что ваш токен доступа или учетные данные email/пароль действительны

3. Замените учетные данные в конфигурации вашего MCP-клиента

4. Сохраните и перезапустите ваш MCP-клиент

Убедитесь, что у вас установлены Node и NPM

• Node.js

• 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

🚧 Режим разработки

Если вы хотите запустить сервер в режиме разработки:

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

🌐 HTTP-транспорт (многопользовательские / удаленные развертывания)

По умолчанию сервер использует транспорт stdio, который идеально подходит для локальных AI-редакторов с одним пользователем (Cursor, Claude Desktop и т.д.).

Для многопользовательских или удаленных сред вы можете переключиться на Streamable HTTP transport, установив переменную окружения MCP_TRANSPORT.

Конфигурация

Вы также можете передать --transport=http в качестве аргумента CLI вместо установки переменной окружения.

Запуск HTTP-сервера

# Via environment variable
MCP_TRANSPORT=http MCP_PORT=3000 MCP_HOST=0.0.0.0 node dist/index.js

# Via CLI argument
node dist/index.js --transport=http

Пример Docker

docker run -p 3000:3000 \
  -e DIRECTUS_URL=https://your-directus-instance.com \
  -e DIRECTUS_ACCESS_TOKEN=your_token_here \
  -e MCP_TRANSPORT=http \
  -e MCP_HOST=0.0.0.0 \
  ghcr.io/pixelsock/directus-mcp

Подключение MCP-клиента к HTTP-серверу

После запуска сервера настройте ваш MCP-клиент для подключения к:

http://<host>:<port>/mcp

Например, с клиентом, который поддерживает Streamable HTTP transport:

{
  "mcpServers": {
    "directus": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

📄 Ресурсы для разработчиков Directus

• Документация API Directus

• Конечные точки API Directus

• JavaScript SDK Directus