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
▶️ 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"
}
}
}
}
{
"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"
}
}
}
}
- Vaya a Configuración → Configuración del cursor → MCP
- Haga clic en
+ Add New Global MCP Server - Pegar configuración
- Reemplace los valores de marcador de posición con sus credenciales de Directus
- Guardar y reiniciar el cursor
Para Claude Desktop:
- Abrir Configuración → Desarrollador
- Haga clic en
Edit Config - Abra
claude_desktop_config.json en un editor de código y pegue la configuración - Reemplace los valores de marcador de posición con sus credenciales de Directus
- 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:
Limpia tu caché de NPM
A veces, borrar el caché de NPM puede resolver problemas con npx .
🛠️ 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:
📄 Recursos para desarrolladores de Directus