====== Model Context Protocol Plugin ======

---- plugin ----
description: Make the Remote API available as MCP server
author     : andi 
email      : andi@splitbrain.org 
type       : 
lastupdate : 2025-07-02
compatible : 
depends    : 
conflicts  : 
similar    : 
tags       : !experimental, ai

downloadurl: https://github.com/splitbrain/dokuwiki-plugin-mcp/zipball/master
bugtracker : https://github.com/splitbrain/dokuwiki-plugin-mcp/issues
sourcerepo : https://github.com/splitbrain/dokuwiki-plugin-mcp
donationurl: 

screenshot_img : # URL to a screenshot of the plugin in action
----

This is a proof-of-concept plugin! This plugin implements a Model Context Protocol (MCP) server for DokuWiki. This means you can give your MCP-capable AI client access to DokuWiki API calls as LLM tools.

It is basically a thin wrapper around the [[devel:remote_api|Remote API]]. It uses the new (March 2025) Streaming HTTP transport.

Note: even though not clearly defined in the MCP specification, some tools seem not to like dots in tool names. Thus this plugin converts them into underscores. Eg. the DokuWiki API call ''core.getVersion'' becomes the ''core_getVersion'' tool in this plugin.

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Usage =====

First enable and configure the [[devel:remote_api|Remote API]]. Then configure your client to use ''%%https://example.com/dokuwiki/lib/plugins/mcp/mcp.php%%'' (adjust to your base URL as needed) as remote MCP tool server. Be sure to also set an access token via [[devel:authentication#token_auth|the Bearer Auth header]].

Below is an example in [[https://github.com/modelcontextprotocol/inspector|MCP Inspector]]:

{{:plugin:mcp-explorer.png?800|MCP Inspector}}


Tools not supporting the streaming HTTP transport natively yet, can use the [[https://github.com/geelen/mcp-remote|mcp-remote]] tool.

<code>
{
  "mcpServers": {
    "dokuwiki": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://example.com/dokuwiki/lib/plugins/mcp/mcp.php",
        "--header",
        "Authorization: Bearer mytoken"
      ],
    },
  }
}
</code>