Drupal MCP Server

<?php

namespace Drupal\drupal_mcp\Controller;

use Drupal\Core\Controller\ControllerBase;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpFoundation\Request;

class UploadMediaController extends ControllerBase {

  public function execute(Request $request): JsonResponse {
    $data = json_decode($request->getContent(), TRUE);

    if (empty($data['file']) || empty($data['filename'])) {
      return new JsonResponse([
        'error' => 'Missing required fields: file (base64), filename',
      ], 400);
    }

    // Décoder le fichier base64
    $file_data = base64_decode($data['file']);
    $directory = 'public://mcp-uploads/' . date('Y-m');
    \Drupal::service('file_system')->prepareDirectory(
      $directory, 
      \Drupal\Core\File\FileSystemInterface::CREATE_DIRECTORY
    );

    $file = \Drupal::service('file.repository')->writeData(
      $file_data,
      $directory . '/' . $data['filename'],
      \Drupal\Core\File\FileExists::Rename
    );

    // Créer l'entité Media
    $media = \Drupal\media\Entity\Media::create([
      'bundle'            => $data['media_type'] ?? 'image',
      'name'              => $data['alt'] ?? $data['filename'],
      'field_media_image' => [
        'target_id' => $file->id(),
        'alt'       => $data['alt'] ?? $data['filename'],
      ],
      'status' => 1,
    ]);
    $media->save();

    return new JsonResponse([
      'success'  => TRUE,
      'mid'      => (int) $media->id(),
      'fid'      => (int) $file->id(),
      'url'      => \Drupal::service('file_url_generator')
                     ->generateAbsoluteString($file->getFileUri()),
    ], 201);
  }

}

{
  "name": "drupal-mcp-server",
  "version": "1.0.0",
  "description": "Drupal CMS — MCP Server",
  "tools": [
    {
      "name": "create_node",
      "description": "Create a new content node in Drupal",
      "inputSchema": {
        "type": "object",
        "properties": {
          "type":   { "type": "string", "description": "Content type machine name" },
          "title":  { "type": "string", "description": "Node title" },
          "body":   { "type": "string", "description": "Body content (HTML)" },
          "status": { "type": "integer", "description": "1=published, 0=draft" },
          "fields": { "type": "object", "description": "Additional fields" }
        },
        "required": ["type", "title"]
      }
    },
    {
      "name": "upload_media",
      "description": "Upload an image or file to Drupal media library",
      "inputSchema": {
        "type": "object",
        "properties": {
          "file":       { "type": "string", "description": "Base64 encoded file" },
          "filename":   { "type": "string", "description": "File name with extension" },
          "alt":        { "type": "string", "description": "Alt text for images" },
          "media_type": { "type": "string", "description": "Media bundle (image, document)" }
        },
        "required": ["file", "filename"]
      }
    }
  ],
  "resources": [
    { "uri": "drupal://content_types", "name": "Content Types", "description": "Available content types" },
    { "uri": "drupal://taxonomy/{vid}", "name": "Taxonomy Terms", "description": "Terms for a vocabulary" }
  ]
}

access mcp api:
  title: 'Access MCP API'
  description: 'Access the MCP discovery endpoint and tool listing'

mcp create content:
  title: 'MCP: Create content'
  description: 'Create nodes via MCP tools'
  restrict access: true

mcp upload media:
  title: 'MCP: Upload media'
  description: 'Upload files and create media entities via MCP'
  restrict access: true

mcp publish content:
  title: 'MCP: Publish content'
  description: 'Publish or unpublish nodes via MCP'
  restrict access: true

mcp delete content:
  title: 'MCP: Delete content'
  description: 'Delete nodes via MCP (dangerous)'
  restrict access: true

{
  "mcpServers": {
    "drupal": {
      "url": "https://your-site.com/mcp",
      "transport": "rest",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}