drupal-rag-mcp

# Drupal RAG MCP <img src="media/screenshot.png" alt="Drupal Agent Screenshot" style="max-width: 150px;"> A Model Context Protocol (MCP) server that gives AI coding assistants direct access to Drupal projects through: * Drupal codebase search (RAG) * File reading * File writing * Drupal route discovery * Safe Drupal command execution * Project file listing This server is designed for use with MCP-compatible clients such as: * Claude Desktop * Claude Code * Cursor * Windsurf * Cline * OpenAI Codex CLI * Other MCP-compatible tools --- ## Features ### Search Drupal Knowledge Base Search indexed Drupal source code and documentation using semantic search. Tool: ```text search_drupal_docs ``` ### Read Drupal Files Read any file within the configured Drupal project. Tool: ```text read_drupal_file ``` ### Write Drupal Files Create or update files inside the Drupal project. Tool: ```text write_drupal_file ``` ### Run Drupal Commands Execute approved Drupal development commands. Supported commands: * drush * composer * phpunit Tool: ```text run_drupal_command ``` ### List Project Files Browse project source files without using embeddings. Tool: ```text list_project_files ``` ### Discover Drupal Routes Search Drupal routes by: * Route name * Path * Controller * Form * Permission * Title Tool: ```text find_routes ``` --- # Architecture ```text AI Client │ ▼ Drupal MCP Server │ ▼ Drupal RAG API │ ├── Chroma Vector Database ├── Drupal Source Code └── Drupal Documentation ``` The MCP server communicates with a local FastAPI service that performs indexing, search, file operations, and command execution. --- # Installation Install from PyPI: ```bash pip install drupal-rag-mcp ``` Or install with RAG dependencies: ```bash pip install "drupal-rag-mcp[rag]" ``` --- # Requirements * Python 3.10+ * Drupal project * Composer * Drush (optional) * ChromaDB --- # Build Your Drupal RAG Create a .drupal-rag folder…