index.html

---
layout: default
title: Drupal Tools MCP Server
---

<div class="container">
  <div class="row">
    <div class="col-md-12">
      
      <p>A simple MCP (Model Context Protocol) server that suggests Drupal tools from the <code>_data/projects</code> folder. This server provides semantic search and discovery of Drupal development tools, utilities, and projects.</p>

      <h2>Features</h2>
      <ul>
        <li><strong>list_tools</strong>: List all available Drupal tools/projects with optional filtering</li>
        <li><strong>search_tools</strong>: Search for tools using semantic matching</li>
        <li><strong>get_tool</strong>: Get detailed information about a specific tool</li>
      </ul>

      <h2>Using npx</h2>

      <p>Add the following to your <strong>mcpServers</strong> json key:</p>

      <div class="highlight">
        <pre>
{
  "mcpServers": {
    "drupaltools": {
      "type": "stdio",
      "command": "npx",
      "args": ["@drupaltools/mcp@latest"]
    }
  }
}
        </pre>
      </div>

      <h2>Local install with npm</h2>

      <div class="highlight">
<pre>npm install -g @drupaltools/mcp</pre>
<pre>
  {
    "mcpServers": {
      "drupaltools": {
        "type": "stdio",
        "command": "drupaltools-mcp"
      }
    }
  }
</pre>
      </div>

      <h2>Available Tools</h2>

      <h3>1. list_tools</h3>
      <p>Lists all available Drupal tools/projects.</p>

      <p><strong>Parameters:</strong></p>
      <ul>
        <li><code>category</code> (optional): Filter by category (e.g., 'testing', 'cli', 'deployment')</li>
        <li><code>limit</code> (optional, default: 50): Maximum number of tools to return</li>
      </ul>

      <h3>2. search_tools</h3>
      <p>Search for tools using a query string. Uses smart scoring:</p>
      <ul>
        <li>Title matches: 100 points</li>
        <li>Category matches: 50 points</li>
        <li>Tag matches: 30 points</li>
        <li>Description matches: 20 points</li>
        <li>Homepage/source matches: 10 points</li>
      </ul>

      <p><strong>Parameters:</strong></p>
      <ul>
        <li><code>query</code> (required): Search query</li>
        <li><code>limit</code> (optional, default: 10): Maximum results to return</li>
      </ul>

      <h3>3. get_tool</h3>
      <p>Get detailed information about a specific tool by ID or name.</p>

      <p><strong>Parameters:</strong></p>
      <ul>
        <li><code>tool_id</code> (required): The tool ID (filename without .yml) or tool name</li>
      </ul>

      <h2>Example Usage and prompts</h2>
      <code>
        Show me 5 Drupal tools for testing Drupal sites
        Search for Docker-based Drupal development tools
        Tell me about ddev tool
        List all CLI tools for Drupal that are deprecated
      </code>

      <h2>Development</h2>

      <p>The server is built using the JavaScript/TypeScript MCP SDK (<code>@modelcontextprotocol/sdk</code> v1.24.3) with ES modules.</p>

      <h2>Testing</h2>

      <div class="highlight">
        <pre>npx @modelcontextprotocol/inspector drupaltools-mcp</pre>
      </div>

      <p>This opens a web UI where you can:</p>
      <ul>
        <li>See all available tools and their schemas</li>
        <li>Test each tool with custom parameters</li>
        <li>View real-time responses</li>
        <li>Debug issues</li>
      </ul>
    </div>
  </div>
</div>