drupal-mcp-server 0.1.0__tar.gz → 0.2.0__tar.gz

drupal_mcp_server-0.2.0/.codecov.yml

@@ -0,0 +1,17 @@
+coverage:
+  # The 367 tool modules are thin wrappers exercised by the live test harness,
+  # which needs a real Drupal site and cannot run in CI. The CI gate (70%)
+  # deliberately excludes them, so keep Codecov consistent with CI.
+  ignore:
+    - "src/drupal_mcp_server/tools/*"
+
+  status:
+    project:
+      default:
+        target: 80%
+        threshold: 2%
+        informational: true
+    patch:
+      default:
+        target: 80%
+        informational: true

{drupal_mcp_server-0.1.0 → drupal_mcp_server-0.2.0}/.github/workflows/ci.yml

@@ -46,10 +46,13 @@ jobs:
       uses: codecov/codecov-action@v4
       with:
         files: ./coverage.xml
+        token: ${{ secrets.CODECOV_TOKEN }}
         fail_ci_if_error: true
 
     - name: Dependency vulnerability scan
-      run: pip-audit
+      run: |
+        pip install --upgrade "setuptools>=83.0.0"
+        pip-audit
 
   build:
     runs-on: ubuntu-latest

{drupal_mcp_server-0.1.0 → drupal_mcp_server-0.2.0}/.github/workflows/docs.yml

@@ -7,15 +7,24 @@ on:
       - 'docs/**'
       - 'mkdocs.yml'
       - 'README.md'
+      - '.github/workflows/docs.yml'
   pull_request:
     paths:
       - 'docs/**'
       - 'mkdocs.yml'
       - 'README.md'
+      - '.github/workflows/docs.yml'
 
 jobs:
   docs:
     runs-on: ubuntu-latest
+    # peaceiris/actions-gh-pages pushes the built site to the gh-pages
+    # branch, which requires write access. The repo's default workflow
+    # token is read-only, so grant it explicitly here.
+    permissions:
+      contents: write
+      pages: write
+      id-token: write
 
     steps:
     - uses: actions/checkout@v4

{drupal_mcp_server-0.1.0 → drupal_mcp_server-0.2.0}/.gitignore

@@ -56,10 +56,22 @@ htmlcov/
 # Ruff
 .ruff_cache/
 
+# mkdocs build output
+site/
+
 # Environment
 .env
 .env.local
 .env.*.local
+.env.live-smoke
+# Env files generated by the live migration harness scripts (contain
+# local dev credentials).
+.env.live
+.env.d9d11
+.env.d7d11
+
+# Runtime migration-plan state written by MigrationService
+.drupal-mcp/
 
 # OS
 .DS_Store

{drupal_mcp_server-0.1.0 → drupal_mcp_server-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: drupal-mcp-server
-Version: 0.1.0
+Version: 0.2.0
 Summary: MCP server for Drupal operations - JSON:API, GraphQL, Drush, AI-powered migration
 Author: Loganathane V
 License: MIT
@@ -44,11 +44,12 @@ Description-Content-Type: text/markdown
 
 [![CI](https://github.com/vloganathane/drupal-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/vloganathane/drupal-mcp-server/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/vloganathane/drupal-mcp-server/branch/main/graph/badge.svg)](https://codecov.io/gh/vloganathane/drupal-mcp-server)
-[![PyPI version](https://badge.fury.io/py/drupal-mcp-server.svg)](https://badge.fury.io/py/drupal-mcp-server)
+[![PyPI version](https://img.shields.io/pypi/v/drupal-mcp-server.svg)](https://pypi.org/project/drupal-mcp-server/)
 [![Python versions](https://img.shields.io/pypi/pyversions/drupal-mcp-server.svg)](https://pypi.org/project/drupal-mcp-server/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/drupal-mcp-server.svg)](https://pypi.org/project/drupal-mcp-server/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/vloganathane/drupal-mcp-server/blob/main/LICENSE)
 
-A Model Context Protocol (MCP) server for Drupal operations. Provides **367 tools across 37 modules** for site analysis, migration, content management, configuration, commerce, headless, DevOps, security, and more.
+A Model Context Protocol (MCP) server for Drupal operations. Provides **392 tools across 38 modules** for site analysis, migration, content management, configuration, commerce, headless, DevOps, security, and more.
 
 ## Why Use This?
 
@@ -130,6 +131,27 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
+## AI Coding Agents
+
+Register the server with any MCP client in one command:
+
+```bash
+drupal-mcp install
+```
+
+It detects the agents on your machine — Claude Code, Claude Desktop, Cursor,
+Codex CLI, OpenCode, Windsurf, Pi, Hermes Agent and OpenClaw — gathers
+`DRUPAL_*` settings from `./.env` or the environment, and writes each client's
+config (preferring the client's own `mcp add` command when it has one).
+
+```bash
+drupal-mcp install --client claude-code --print   # preview without writing
+drupal-mcp install --command 'uvx drupal-mcp-server'  # run from PyPI, no install
+```
+
+See the [AI Coding Agents guide](docs/agents.md) for per-client copy-paste
+snippets, options, and caveats.
+
 ## Configuration
 
 ### Drupal connection
@@ -181,7 +203,7 @@ Set `MCP_TRANSPORT` to one of:
 - `sse` (for Server-Sent Events)
 - `streamable-http` (for Streamable HTTP)
 
-## Tools (367 total)
+## Tools (392 total)
 
 ### Accessibility (5)
 - `accessibility_axe_scan` — Run axe-core accessibility scan
@@ -213,6 +235,11 @@ Set `MCP_TRANSPORT` to one of:
 - `composer_audit` — Composer dependency audit
 - `code_quality_report` — Combined code quality report
 
+### Codebase (12)
+- `codebase_index_refresh`, `codebase_search`, `codebase_module_list`, `codebase_module_describe`
+- `codebase_unused_modules`, `codebase_redundancy_check`, `codebase_hooks_find`, `codebase_paths_list`
+- `codebase_files_list`, `codebase_directory_tree`, `codebase_file_read`, `codebase_function_read`
+
 ### Comments (10)
 - `comment_list`, `comment_get`, `comment_create`, `comment_update`, `comment_delete`
 - `comment_thread_list`, `comment_approve`, `comment_unapprove`
@@ -251,9 +278,10 @@ Set `MCP_TRANSPORT` to one of:
 - `composer_install`, `composer_require`, `composer_update`
 - `drush_cron`, `drush_watchdog`, `cache_clear`, `drush_updb`, `drush_php_eval`
 
-### Drupal.org (9)
+### Drupal.org (12)
 - `module_search`, `module_get`, `module_versions`, `module_dependencies`, `module_compatibility`
 - `theme_search`, `theme_get`, `release_history`, `project_usage`
+- `module_issues_search`, `module_popular`, `module_recommendation`
 
 ### Feeds (12)
 - `feeds_feed_list`, `feeds_feed_get`, `feeds_feed_create`, `feeds_feed_update`, `feeds_feed_delete`
@@ -298,7 +326,7 @@ displays have Layout Builder enabled; `layout_builder_get`,
 - `metatag_defaults_get`, `metatag_defaults_set`, `metatag_token_list`
 - `metatag_canonical_set`, `metatag_jsonld_generate`
 
-### Migration (7)
+### Migration (17)
 - `generate_migration_yaml` — Generate migration YAML
 - `generate_module_migration` — Generate migration module
 - `run_migration_test` — Test migration with limited records
@@ -306,6 +334,16 @@ displays have Layout Builder enabled; `layout_builder_get`,
 - `rollback_migration` — Rollback a migration
 - `sync_media_files` — Sync media between paths
 - `migrate_taxonomy` — Migrate taxonomy vocabularies
+- `create_migration_plan` — Create a persisted migration manifest
+- `get_migration_plan` — Read a migration manifest and tracked state
+- `list_migration_plans` — List migration manifests
+- `migration_status` — Summarize migration progress
+- `migrate_records` — Copy a batch of source records to the target site
+- `record_migration_result` — Record externally executed migration outcomes
+- `analyze_source_site` — Analyze a source Drupal JSON:API resource type
+- `reconcile_migration_counts` — Compare source and target counts
+- `run_migration_wave` — Fetch and migrate one source resource type
+- `run_migration` — Run an ordered end-to-end migration for all planned types
 
 ### Moderation (13)
 - `moderation_state_list`, `moderation_state_get`, `moderation_state_create`, `moderation_state_update`, `moderation_state_delete`
@@ -393,10 +431,10 @@ displays have Layout Builder enabled; `layout_builder_get`,
 
 ## Documentation
 
-- [Contributing Guide](CONTRIBUTING.md)
-- [Changelog](CHANGELOG.md)
-- [Security Policy](SECURITY.md)
-- [Code of Conduct](CODE_OF_CONDUCT.md)
+- [Contributing Guide](docs/CONTRIBUTING.md)
+- [Changelog](docs/CHANGELOG.md)
+- [Security Policy](docs/SECURITY.md)
+- [Code of Conduct](docs/CODE_OF_CONDUCT.md)
 - [Architecture](docs/architecture.md)
 - [Migration Guide](docs/migration.md)
 - [Docstring Standard](docs/docstring_standard.md)
@@ -491,7 +529,7 @@ python tests/live/queue_test.py           # 18 cron/queue cases, ~60s
 python tests/live/filter_check.py         # every hard-coded JSON:API filter
 python tests/live/resource_check.py       # every resource name, asked of Drupal
 python tests/live/install_modules.py      # the modules the tools assume, ~10 min
-python tests/live/sweep.py                # all 367 tools, ~30 min
+python tests/live/sweep.py                # all 392 tools, ~30 min
 python tests/live/mcp_call.py content_list '{}'  # one call, for spot checks
 ```
 

{drupal_mcp_server-0.1.0 → drupal_mcp_server-0.2.0}/README.md

@@ -2,11 +2,12 @@
 
 [![CI](https://github.com/vloganathane/drupal-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/vloganathane/drupal-mcp-server/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/vloganathane/drupal-mcp-server/branch/main/graph/badge.svg)](https://codecov.io/gh/vloganathane/drupal-mcp-server)
-[![PyPI version](https://badge.fury.io/py/drupal-mcp-server.svg)](https://badge.fury.io/py/drupal-mcp-server)
+[![PyPI version](https://img.shields.io/pypi/v/drupal-mcp-server.svg)](https://pypi.org/project/drupal-mcp-server/)
 [![Python versions](https://img.shields.io/pypi/pyversions/drupal-mcp-server.svg)](https://pypi.org/project/drupal-mcp-server/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/drupal-mcp-server.svg)](https://pypi.org/project/drupal-mcp-server/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/vloganathane/drupal-mcp-server/blob/main/LICENSE)
 
-A Model Context Protocol (MCP) server for Drupal operations. Provides **367 tools across 37 modules** for site analysis, migration, content management, configuration, commerce, headless, DevOps, security, and more.
+A Model Context Protocol (MCP) server for Drupal operations. Provides **392 tools across 38 modules** for site analysis, migration, content management, configuration, commerce, headless, DevOps, security, and more.
 
 ## Why Use This?
 
@@ -88,6 +89,27 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
+## AI Coding Agents
+
+Register the server with any MCP client in one command:
+
+```bash
+drupal-mcp install
+```
+
+It detects the agents on your machine — Claude Code, Claude Desktop, Cursor,
+Codex CLI, OpenCode, Windsurf, Pi, Hermes Agent and OpenClaw — gathers
+`DRUPAL_*` settings from `./.env` or the environment, and writes each client's
+config (preferring the client's own `mcp add` command when it has one).
+
+```bash
+drupal-mcp install --client claude-code --print   # preview without writing
+drupal-mcp install --command 'uvx drupal-mcp-server'  # run from PyPI, no install
+```
+
+See the [AI Coding Agents guide](docs/agents.md) for per-client copy-paste
+snippets, options, and caveats.
+
 ## Configuration
 
 ### Drupal connection
@@ -139,7 +161,7 @@ Set `MCP_TRANSPORT` to one of:
 - `sse` (for Server-Sent Events)
 - `streamable-http` (for Streamable HTTP)
 
-## Tools (367 total)
+## Tools (392 total)
 
 ### Accessibility (5)
 - `accessibility_axe_scan` — Run axe-core accessibility scan
@@ -171,6 +193,11 @@ Set `MCP_TRANSPORT` to one of:
 - `composer_audit` — Composer dependency audit
 - `code_quality_report` — Combined code quality report
 
+### Codebase (12)
+- `codebase_index_refresh`, `codebase_search`, `codebase_module_list`, `codebase_module_describe`
+- `codebase_unused_modules`, `codebase_redundancy_check`, `codebase_hooks_find`, `codebase_paths_list`
+- `codebase_files_list`, `codebase_directory_tree`, `codebase_file_read`, `codebase_function_read`
+
 ### Comments (10)
 - `comment_list`, `comment_get`, `comment_create`, `comment_update`, `comment_delete`
 - `comment_thread_list`, `comment_approve`, `comment_unapprove`
@@ -209,9 +236,10 @@ Set `MCP_TRANSPORT` to one of:
 - `composer_install`, `composer_require`, `composer_update`
 - `drush_cron`, `drush_watchdog`, `cache_clear`, `drush_updb`, `drush_php_eval`
 
-### Drupal.org (9)
+### Drupal.org (12)
 - `module_search`, `module_get`, `module_versions`, `module_dependencies`, `module_compatibility`
 - `theme_search`, `theme_get`, `release_history`, `project_usage`
+- `module_issues_search`, `module_popular`, `module_recommendation`
 
 ### Feeds (12)
 - `feeds_feed_list`, `feeds_feed_get`, `feeds_feed_create`, `feeds_feed_update`, `feeds_feed_delete`
@@ -256,7 +284,7 @@ displays have Layout Builder enabled; `layout_builder_get`,
 - `metatag_defaults_get`, `metatag_defaults_set`, `metatag_token_list`
 - `metatag_canonical_set`, `metatag_jsonld_generate`
 
-### Migration (7)
+### Migration (17)
 - `generate_migration_yaml` — Generate migration YAML
 - `generate_module_migration` — Generate migration module
 - `run_migration_test` — Test migration with limited records
@@ -264,6 +292,16 @@ displays have Layout Builder enabled; `layout_builder_get`,
 - `rollback_migration` — Rollback a migration
 - `sync_media_files` — Sync media between paths
 - `migrate_taxonomy` — Migrate taxonomy vocabularies
+- `create_migration_plan` — Create a persisted migration manifest
+- `get_migration_plan` — Read a migration manifest and tracked state
+- `list_migration_plans` — List migration manifests
+- `migration_status` — Summarize migration progress
+- `migrate_records` — Copy a batch of source records to the target site
+- `record_migration_result` — Record externally executed migration outcomes
+- `analyze_source_site` — Analyze a source Drupal JSON:API resource type
+- `reconcile_migration_counts` — Compare source and target counts
+- `run_migration_wave` — Fetch and migrate one source resource type
+- `run_migration` — Run an ordered end-to-end migration for all planned types
 
 ### Moderation (13)
 - `moderation_state_list`, `moderation_state_get`, `moderation_state_create`, `moderation_state_update`, `moderation_state_delete`
@@ -351,10 +389,10 @@ displays have Layout Builder enabled; `layout_builder_get`,
 
 ## Documentation
 
-- [Contributing Guide](CONTRIBUTING.md)
-- [Changelog](CHANGELOG.md)
-- [Security Policy](SECURITY.md)
-- [Code of Conduct](CODE_OF_CONDUCT.md)
+- [Contributing Guide](docs/CONTRIBUTING.md)
+- [Changelog](docs/CHANGELOG.md)
+- [Security Policy](docs/SECURITY.md)
+- [Code of Conduct](docs/CODE_OF_CONDUCT.md)
 - [Architecture](docs/architecture.md)
 - [Migration Guide](docs/migration.md)
 - [Docstring Standard](docs/docstring_standard.md)
@@ -449,7 +487,7 @@ python tests/live/queue_test.py           # 18 cron/queue cases, ~60s
 python tests/live/filter_check.py         # every hard-coded JSON:API filter
 python tests/live/resource_check.py       # every resource name, asked of Drupal
 python tests/live/install_modules.py      # the modules the tools assume, ~10 min
-python tests/live/sweep.py                # all 367 tools, ~30 min
+python tests/live/sweep.py                # all 392 tools, ~30 min
 python tests/live/mcp_call.py content_list '{}'  # one call, for spot checks
 ```
 

{drupal_mcp_server-0.1.0 → drupal_mcp_server-0.2.0/docs}/CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.2.0] - 2026-10-16
 
 ### Security
 
@@ -17,6 +17,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Add `drupal-mcp install`, a self-installer that registers the server with
+  local MCP clients (Claude Code, Claude Desktop, Cursor, Codex CLI,
+  OpenCode, Windsurf, Pi, Hermes Agent, OpenClaw), with `--print`/`--json`
+  for scripted setup and an AI Coding Agents guide
+- Add `module_issues_search`, `module_popular`, and `module_recommendation`
+  (client-side issue-queue relevance scoring, usage-ranked module lists by
+  category, local-index + drupal.org recommendations), plus the `DRUPAL_ROOT`
+  and `DRUPAL_MODULES_PATH` settings for local codebase analysis
+- Add a local codebase index with 12 `codebase_*` tools: functionality
+  search, module inventory/descriptions, unused and redundant module
+  detection, hook implementation lookup, and safe module file/tree/function
+  reading (all reads confined to `DRUPAL_ROOT`)
 - Add `moderation_transition_delete`, giving `moderation_transition_create` the
   counterpart it never had. The tool count is now 367
 - Add Lando support to SiteManager

drupal_mcp_server-0.2.0/docs/agents.md

@@ -0,0 +1,221 @@
+# Use with AI Coding Agents
+
+Every MCP client needs the same three things: a command to spawn, arguments,
+and the `DRUPAL_*` environment variables. Assembling those by hand differs
+per client, so the server ships a self-installer that does it for you.
+
+## One command
+
+```bash
+drupal-mcp install
+```
+
+With no arguments it:
+
+1. **Detects** the MCP clients on this machine (Claude Code, Claude Desktop,
+   Cursor, Codex CLI, OpenCode, Windsurf, Pi, Hermes Agent, OpenClaw) — by
+   finding their CLI on `PATH` or a known config path.
+2. **Gathers** `DRUPAL_*` settings from `./.env`, the process environment and
+   any `--env` flags (precedence: dotenv < environment < flags).
+3. **Writes** each client's config — preferring the client's own `mcp add`
+   command when it has one, otherwise writing the documented file directly.
+
+```
+✓ claude-code: Added stdio MCP server drupal ... to local config
+✓ codex: Added global MCP server 'drupal'.
+✓ opencode: MCP server "drupal" added to ./opencode.json
+```
+
+## Useful options
+
+| Option | Effect |
+|--------|--------|
+| `--client NAME` | Configure only this client (repeatable) |
+| `--all` | Configure every supported client |
+| `--list` | List supported client names |
+| `--print` | Print the config/commands without writing anything |
+| `--json` | Emit results as JSON (for scripted/agent-driven setup) |
+| `--env KEY=VALUE` | Extra environment variable (repeatable) |
+| `--dotenv PATH` | Env file to read (default `./.env` if present) |
+| `--name NAME` | Server name inside the client config (default `drupal`) |
+| `--command CMD` | Launch command override, e.g. `--command 'uvx drupal-mcp-server'` |
+| `--scope local\|user\|project` | Claude Code configuration scope |
+| `--global` | OpenCode: write the global config instead of the project one |
+
+## What gets written where
+
+| Client | Config | Mechanism |
+|--------|--------|-----------|
+| Claude Code | `claude mcp add` (or `./.mcp.json` with `--scope project`) | client CLI |
+| Claude Desktop | `claude_desktop_config.json` (`mcpServers`) | direct write |
+| Cursor | `~/.cursor/mcp.json` (`mcpServers`) | direct write |
+| Codex CLI | `codex mcp add` (or `~/.codex/config.toml`) | client CLI |
+| OpenCode | `opencode mcp add` (or `opencode.json` → `mcp.servers`) | client CLI |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` (`mcpServers`) | direct write |
+| Pi | `pi mcp add` (or `~/.pi/agent/mcp.json`) | client CLI |
+| Hermes Agent | `~/.hermes/config.yaml` (`mcp_servers`) | direct write |
+| OpenClaw | `openclaw mcp add` | client CLI (required) |
+
+The launch command is the absolute path to the `drupal-mcp` script when it is
+on `PATH` (GUI clients like Claude Desktop launch servers with a sanitized
+environment, so a bare name can fail there); otherwise `uvx drupal-mcp-server`
+runs it straight from PyPI.
+
+Existing configs are merged, never clobbered: other servers in the same file
+survive, a server of the same name is replaced (so re-running is idempotent),
+and a config that fails to parse is left untouched with an error instead of
+being overwritten.
+
+## Manual setup (copy-paste)
+
+If you would rather wire it up yourself — every command below is verified
+against the client's current CLI or docs:
+
+=== "Claude Code"
+
+    ```bash
+    claude mcp add drupal \
+      -e DRUPAL_BASE_URL=https://your-site.example \
+      -e DRUPAL_USERNAME=admin \
+      -e DRUPAL_PASSWORD=secret \
+      -- drupal-mcp
+    ```
+
+=== "Claude Desktop"
+
+    ```json
+    {
+      "mcpServers": {
+        "drupal": {
+          "command": "drupal-mcp",
+          "args": [],
+          "env": {
+            "DRUPAL_BASE_URL": "https://your-site.example",
+            "DRUPAL_USERNAME": "admin",
+            "DRUPAL_PASSWORD": "secret"
+          }
+        }
+      }
+    }
+    ```
+
+=== "Cursor"
+
+    ```json
+    {
+      "mcpServers": {
+        "drupal": {
+          "command": "drupal-mcp",
+          "args": [],
+          "env": {
+            "DRUPAL_BASE_URL": "https://your-site.example",
+            "DRUPAL_USERNAME": "admin",
+            "DRUPAL_PASSWORD": "secret"
+          }
+        }
+      }
+    }
+    ```
+
+=== "Codex CLI"
+
+    ```bash
+    codex mcp add drupal \
+      --env DRUPAL_BASE_URL=https://your-site.example \
+      --env DRUPAL_USERNAME=admin \
+      --env DRUPAL_PASSWORD=secret \
+      -- drupal-mcp
+    ```
+
+=== "OpenCode"
+
+    ```bash
+    opencode mcp add drupal \
+      --env DRUPAL_BASE_URL=https://your-site.example \
+      --env DRUPAL_USERNAME=admin \
+      --env DRUPAL_PASSWORD=secret \
+      -- drupal-mcp
+    ```
+
+=== "Windsurf"
+
+    ```json
+    {
+      "mcpServers": {
+        "drupal": {
+          "command": "drupal-mcp",
+          "args": [],
+          "env": {
+            "DRUPAL_BASE_URL": "https://your-site.example",
+            "DRUPAL_USERNAME": "admin",
+            "DRUPAL_PASSWORD": "secret"
+          }
+        }
+      }
+    }
+    ```
+
+=== "Pi"
+
+    ```bash
+    pi mcp add drupal \
+      --env DRUPAL_BASE_URL=https://your-site.example \
+      --env DRUPAL_USERNAME=admin \
+      --env DRUPAL_PASSWORD=secret \
+      -- drupal-mcp
+    ```
+
+=== "Hermes Agent"
+
+    ```yaml
+    # ~/.hermes/config.yaml
+    mcp_servers:
+      drupal:
+        command: "drupal-mcp"
+        env:
+          DRUPAL_BASE_URL: "https://your-site.example"
+          DRUPAL_USERNAME: "admin"
+          DRUPAL_PASSWORD: "secret"
+    ```
+
+=== "OpenClaw"
+
+    ```bash
+    openclaw mcp add drupal \
+      --command drupal-mcp \
+      --env DRUPAL_BASE_URL=https://your-site.example \
+      --env DRUPAL_USERNAME=admin \
+      --env DRUPAL_PASSWORD=secret \
+      --no-probe
+    ```
+
+    OpenClaw's `mcp add` refuses to run while the local Gateway is up — stop it
+    first, then verify with `openclaw mcp doctor drupal --probe`.
+
+## No local install?
+
+Point any client at PyPI directly:
+
+```bash
+drupal-mcp install --command 'uvx drupal-mcp-server'
+```
+
+## Verify
+
+After installing, restart the client and ask it something that must touch
+Drupal, for example *"list my content types"* (the agent should call
+`content_list`). Client-side checks also help:
+
+- Claude Code: `/mcp` shows the server and its connection state
+- OpenClaw: `openclaw mcp status --verbose`, then `openclaw mcp probe drupal`
+- Hermes: `hermes mcp test drupal`
+- Pi: `pi mcp list`
+
+## Security notes
+
+The written config contains your `DRUPAL_*` values, including the password.
+Project-scope files that live inside a repository (`.mcp.json`,
+`opencode.json`) can end up committed — the installer warns when it writes
+credentials into the current directory. Prefer `--scope local` for Claude
+Code (stored outside the repo) or keep secrets in `~/.env`-style files
+outside the project and reference them from the client yourself.

{drupal_mcp_server-0.1.0 → drupal_mcp_server-0.2.0}/docs/index.md

@@ -1,6 +1,6 @@
 # Drupal MCP Server
 
-A Model Context Protocol (MCP) server for Drupal operations. Provides 35+ tools for site analysis, migration, content management, configuration, and DevOps operations.
+A Model Context Protocol (MCP) server for Drupal operations. Provides 392 tools across 38 modules for site analysis, migration, content management, configuration, commerce, headless, DevOps, security, and more.
 
 ## Quick Links
 
@@ -11,15 +11,19 @@ A Model Context Protocol (MCP) server for Drupal operations. Provides 35+ tools
 
 ## Features at a Glance
 
+A sample of the catalog — the full list of all 392 tools lives in the
+[README's Tools section](https://github.com/vloganathane/drupal-mcp-server#tools-392-total).
+
 | Category | Tools | Description |
 |----------|-------|-------------|
-| Content | 12 | CRUD for nodes, media, users, taxonomy, comments |
-| Users | 8 | User management, roles, permissions |
-| DevOps | 10 | DDEV/Lando, Drush, database, cron |
-| Security | 6 | Audits, scanning, permission checks |
-| Migration | 7 | D7 to D10 upgrade assistance |
+| Content | 14 | CRUD for nodes, media, users, taxonomy, comments |
+| Users | 12 | User management, roles, permissions |
+| DevOps | 20 | DDEV/Lando, Drush, database, cron |
+| Security Audit | 8 | Audits, scanning, permission checks |
+| Migration | 17 | Plans, batch import, reconciliation between Drupal sites |
 | AI | 4 | Content analysis, field mapping, planning |
-| Module Dev | 10 | Scaffolding for modules, plugins, forms |
+| Module Dev | 12 | Scaffolding for modules, plugins, forms |
+| Codebase | 12 | Local codebase index, hook search, unused module detection |
 
 ## Example: Create a Node