kcofoni avatar

Pmwiki Mcp

kcofoni/pmwiki-mcp

This server connects Claude to your PmWiki installation through a Docker container that reads your wiki.d directory. It exposes three tools: search_wiki for full-text queries with optional case sensitivity, read_page to pull complete page content, and list_pages to browse by group. All wiki pages show up as resources with pmwiki:// URIs. The setup runs over SSE transport and mounts your wiki directory read-only, so Claude can search and read your wiki pages without write access. You'd reach for this if you're running PmWiki and want Claude to answer questions by searching your documentation or retrieve specific page content on demand.

tools
3
auth
Required
transport
SSE
env var
1
last updated
Mar 22, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

search_wikiSearch for text across all pages.

Search for text across all pages.

No parameter schema in public metadata yet.

read_pageRead the complete content of a page.

Read the complete content of a page.

No parameter schema in public metadata yet.

list_pagesList all wiki pages.

List all wiki pages.

No parameter schema in public metadata yet.

Sponsors

Configuration

WIKI_DIR*

Path to the PmWiki wiki.d directory containing page files (must be mounted as read-only volume in Docker)

Readme

PmWiki MCP Server

MCP (Model Context Protocol) server for interfacing an LLM with PmWiki.

Version française / French version

Architecture

The server uses the MCP protocol with SSE (Server-Sent Events) transport to enable an LLM to interact with your PmWiki instance.

Endpoints

  • GET /sse: SSE connection to establish bidirectional communication
  • POST /messages/: Receive messages from the MCP client

Getting Started

With Docker Compose (Docker Hub image)

The simplest method is to use the published image from Docker Hub:

docker compose up -d

With Docker Compose (local build)

If you want to build the image locally:

  1. Edit docker-compose.yml and comment out the image: line, then uncomment the build: . line
  2. Run:
docker compose up -d --build

Direct Docker Usage

Without docker-compose, you can run directly:

docker run -d \
  --name pmwiki-mcp-server \
  -p 3000:3000 \
  -v /path/to/your/wiki.d:/wiki_data:ro \
  -e WIKI_DIR=/wiki_data \
  kcofoni/pmwiki-mcp:latest

The server will be accessible at http://localhost:3000 (or http://vmtest:3000 from other machines on the network).


View the full README on GitHub

Details

Repository
github.com/kcofoni/pmwiki-mcp
Package
docker.io/kcofoni/pmwiki-mcp:v1.0.4
Transport
SSE
Auth
Required
Registry
MCP registry, active

More from kcofoni