feat: Add MCP server for Drupal tools suggestion

- Implements MCP server using latest @modelcontextprotocol/sdk
- Provides three tools: list_tools, search_tools, and get_tool
- Reads tool data from _data/projects/*.yml files
- Features semantic search with smart scoring system
- Supports category filtering and detailed tool retrieval
- Static-only operation with no external APIs
- Auto-indexing of 186+ Drupal tools

Resolves #39

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>

Author: theodorosploumis

README.md

@@ -48,6 +48,22 @@ bundle install
 bundle exec jekyll serve --server 8080
 ```
 
+## MCP Server
+
+This repository includes an MCP (Model Context Protocol) server that provides programmatic access to the Drupal tools database. See [mcp-server/README.md](./mcp-server/README.md) for details.
+
+### Quick Start
+
+```bash
+npm install
+npm run mcp
+```
+
+The MCP server provides three tools:
+- `list_tools`: List all tools with optional category filtering
+- `search_tools`: Semantic search for tools
+- `get_tool`: Get detailed information about a specific tool
+
 Or just open in Gitpod!
 
 [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/drupaltools/drupaltools.github.io)

mcp-server/.gitignore

@@ -0,0 +1,4 @@
+node_modules
+*.log
+.env
+.DS_Store

mcp-server/README.md

@@ -0,0 +1,145 @@
+# Drupal Tools MCP Server
+
+A simple MCP (Model Context Protocol) server that suggests Drupal tools from the `_data/projects` folder. This server provides semantic search and discovery of Drupal development tools, utilities, and projects.
+
+## Features
+
+- **list_tools**: List all available Drupal tools/projects with optional filtering
+- **search_tools**: Search for tools using semantic matching
+- **get_tool**: Get detailed information about a specific tool
+
+## Setup
+
+1. Install dependencies:
+```bash
+npm install
+```
+
+2. Run the MCP server:
+```bash
+npm run mcp
+```
+
+## Usage with Claude Desktop
+
+Add the following to your Claude Desktop configuration file:
+
+```json
+{
+  "mcpServers": {
+    "drupal-tools": {
+      "command": "node",
+      "args": ["/path/to/drupaltools.github.io/mcp-server/index.js"],
+      "cwd": "/path/to/drupaltools.github.io"
+    }
+  }
+}
+```
+
+## Available Tools
+
+### 1. list_tools
+Lists all available Drupal tools/projects.
+
+**Parameters:**
+- `category` (optional): Filter by category (e.g., 'testing', 'cli', 'deployment')
+- `limit` (optional, default: 50): Maximum number of tools to return
+
+**Example:**
+```javascript
+{
+  "name": "list_tools",
+  "arguments": {
+    "category": "testing",
+    "limit": 10
+  }
+}
+```
+
+### 2. search_tools
+Search for tools using a query string. Uses smart scoring:
+- Title matches: 100 points
+- Category matches: 50 points
+- Tag matches: 30 points
+- Description matches: 20 points
+- Homepage/source matches: 10 points
+
+**Parameters:**
+- `query` (required): Search query
+- `limit` (optional, default: 10): Maximum results to return
+
+**Example:**
+```javascript
+{
+  "name": "search_tools",
+  "arguments": {
+    "query": "docker",
+    "limit": 5
+  }
+}
+```
+
+### 3. get_tool
+Get detailed information about a specific tool by ID or name.
+
+**Parameters:**
+- `tool_id` (required): The tool ID (filename without .yml) or tool name
+
+**Example:**
+```javascript
+{
+  "name": "get_tool",
+  "arguments": {
+    "tool_id": "blt"
+  }
+}
+```
+
+## Data Format
+
+The server reads YAML files from `_data/projects/*.yml`. Each file contains:
+
+```yaml
+name: Tool Name
+year_created: 2020
+source: https://github.com/example/tool
+homepage: https://github.com/example/tool
+docs: https://docs.example.com
+description: "Tool description"
+requires:
+  - git
+  - composer
+drupal_versions:
+  - 9
+  - 10
+category:
+  - testing
+  - cli
+tags:
+  - popular
+similar:
+  - other-tool
+```
+
+## Testing
+
+Run the test suite:
+```bash
+node mcp-server/test.js
+```
+
+Or test individual functionality:
+```bash
+node mcp-server/test-get-tool.js
+```
+
+## Development
+
+The server is built using the [Model Context Protocol SDK](https://modelcontextprotocol.io/docs/sdk).
+
+Key features:
+- Static content only - no external APIs
+- Read-only operations
+- Minimal latency and cost
+- Automatic indexing on startup
+- Deterministic tool suggestions