Servidor Directus MCP

Un servidor Node.js que implementa el Protocolo de Contexto de Modelo (MCP) para Directus CMS. Permite que los clientes de IA interactúen con la API de Directus mediante el Protocolo de Contexto de Modelo (MCP).

ℹ Requisitos previos

▶️ Inicio rápido

Obtenga sus credenciales de API de Directus
- Vaya a su instancia de Directus
- Crea un token de acceso estático u obtén tu correo electrónico y contraseña
- Mantenga estas credenciales seguras
Añadelo a tu editor de IA
{ "mcpServers": { "directus": { "command": "npx", "args": ["-y", "@pixelsock/directus-mcp@latest"], "env": { "DIRECTUS_URL": "https://your-directus-instance.com", "DIRECTUS_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN" } } } }
Alternativamente, puede utilizar la autenticación por correo electrónico/contraseña:
{ "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" } } } }
Para el cursor:
1. Vaya a Configuración → Configuración del cursor → MCP
2. Haga clic en + Add New Global MCP Server
3. Pegar configuración
4. Reemplace los valores de marcador de posición con sus credenciales de Directus
5. Guardar y reiniciar el cursor
Para Claude Desktop:
1. Abrir Configuración → Desarrollador
2. Haga clic en Edit Config
3. Abra claude_desktop_config.json en un editor de código y pegue la configuración
4. Reemplace los valores de marcador de posición con sus credenciales de Directus
5. Guardar y reiniciar Claude

❓ Solución de problemas

Si tiene problemas al iniciar el servidor en su cliente MCP, por ejemplo, Cursor o Claude Desktop, intente lo siguiente.

Asegúrese de tener credenciales de Directus válidas

Verifique que su URL de Directus sea correcta y accesible
Verifique que su token de acceso o credenciales de correo electrónico/contraseña sean válidos
Reemplace las credenciales en la configuración de su cliente MCP
Guarde y reinicie su cliente MCP

Asegúrese de tener Node y NPM instalados

Ejecute los siguientes comandos para confirmar que tiene Node y NPM instalados:

node -v
npm -v

Limpia tu caché de NPM

A veces, borrar el caché de NPM puede resolver problemas con npx .

npm cache clean --force

🛠️ Herramientas disponibles

Colecciones y artículos

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

Archivos

getFiles                // Get files from Directus
uploadFile              // Upload a file to Directus

Usuarios y permisos

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

Sistema

getSystemInfo           // Get system information from Directus
getActivity             // Get activity logs from Directus
getConfig               // Get current configuration information

🚧 Modo de desarrollo

Si desea ejecutar el servidor en modo de desarrollo:

Clonar e instalar:
git clone https://github.com/pixelsock/directus-mcp.git cd directus-mcp npm install
Añade tus credenciales a .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
Iniciar servidor de desarrollo:
npm run dev

Directus MCP Server