insignia de herrería

Servidor MCP de Directus

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

Related MCP server: MCP-MongoDB-MySQL-Server

▶️ 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