drupal / varbase_ai_mcp_server_base
Varbase AI MCP Server: an MCP server for external assistants (Claude.ai and similar) with OAuth 2.1 and a read-only starter tool set. Experimental. Opt-in: never applied by default.
Package info
git.drupalcode.org/project/varbase_ai_mcp_server_base.git
Type:drupal-recipe
pkg:composer/drupal/varbase_ai_mcp_server_base
Requires
- php: >=8.3
- drupal/consumers: ^1.24
- drupal/core: ^11.4
- drupal/mcp: 2.0.x-dev
- drupal/mcp_server: ^2.0@beta
- drupal/mcp_server_oauth: ^1.0@alpha
- drupal/mcp_server_tool_bridge: ^1.0@beta
- drupal/simple_oauth: ^6.1
- drupal/tool: ^1.0@beta
- drupal/tool_belt: ^1.0@alpha
- e0ipso/simple_oauth_21: ^1.13
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-08 15:21:13 UTC
README
Varbase AI MCP Server Base
An opt-in Drupal recipe that lets external assistants (Claude.ai, Claude Desktop, other MCP clients)
read a Varbase 11 site and draft blog posts and pages over the Model Context Protocol:
an MCP server on /mcp, OAuth 2.1, eight read tools and four draft-writing tools. Nothing it writes is ever published:
publishing stays a human action in Drupal.
Documentation
Read the Varbase AI MCP Server Base documentation on the Varbase docs site.
Install and apply
ddev composer config --json extra.drupal-recipe-unpack.ignore '["drupal/varbase_ai_mcp_server_base"]'
ddev composer require drupal/varbase_ai_mcp_server_base:~1
# Rebuild first: the module list is cached from before the require, and the apply
# stops with "is not a known module" without it.
ddev drush cr
ddev drush recipe ../recipes/varbase_ai_mcp_server_base
ddev drush cr
When the project already ignores other packages, add to the unpack list rather
than replacing it. Re-applying is safe. On a site that applied 1.0.x, re-applying turns the mcp:write grants on and
adds the draft permissions and tools. The blog and page content types and varbase_editorial_workflow must
exist (Varbase 11 has them).
Automated testing
GitLab CI on git.drupalcode.org (.gitlab-ci.yml) builds
a Varbase 11 site, applies this recipe twice and runs the Varbase functional testing suite in tests/ on it. See
tests/README.md to run it against a site of your own.