Pmwiki Mcp

io.github.kcofoniPublished by GitHub account kcofoniv1.0.4Updated Oct 24, 2026

MCP server for searching and reading PmWiki pages with text queries and group filtering.

VerifiedSTDIODesktop onlyFiles & StorageKnowledge & Memory

Overview

AI-generated overview

A local Docker-based MCP server that lets an assistant search, list and read pages from a PmWiki wiki.d directory.

What you can do
Search wiki pages by text, optionally case-sensitive, across all pages or a group filter is applied when listing pages by group name, and read the full content of a named page such as Main.HomePage. List all wiki pages, optionally filtered by group. Expose every wiki page as a resource addressed by group and page name.
When to use it
Useful when an assistant should answer questions from an existing PmWiki site, look up or quote page content, or browse the wiki's groups without editing it. It is read-only, so it suits reference and retrieval work rather than authoring.
Requirements
Runs as a local Docker container (image kcofoni/pmwiki-mcp) exposing port 3000 over SSE; the WIKI_DIR environment variable must point to the PmWiki wiki.d directory, mounted read-only. A client-side proxy such as mcp-proxy is needed to connect Claude Desktop to the SSE endpoint.
Before you install
The server reads the wiki.d directory mounted into the container, so only expose a directory you are comfortable sharing with the assistant; the README recommends a read-only mount. The SSE endpoint on port 3000 has no declared authentication, so anyone who can reach it on the network may query the wiki. No write, send or delete tools are described.

Installation

In SourceWeft

  1. Open Pmwiki Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:

bash
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:
bash
docker compose up -d --build

Direct Docker Usage

Without docker-compose, you can run directly:

bash
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).

Verification

bash
# Check that the server is runningdocker logs pmwiki-mcp-server
# Test the SSE connectioncurl -N http://localhost:3000/sse

Client Configuration

Claude Desktop

Add this configuration to your Claude Desktop configuration file:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%\Claude\claude_desktop_config.json

json
{  "mcpServers": {    "pmwiki": {      "command": "mcp-proxy",      "args": [        "--transport=sse",        "http://vmtest:3000/sse"      ]    }  }}

Important notes:

  • vmtest is the hostname of the machine hosting the MCP server Docker container
  • Replace vmtest with:
    • localhost if Claude Desktop runs on the same machine as the server
    • The hostname or IP address of the machine running the Docker container (e.g., 192.168.1.100:3000/sse)
  • The mcp-proxy tool must be installed (usually provided with Claude Desktop)
  • The proxy handles the SSE connection between Claude Desktop and the MCP server

Available Features

Once connected, your LLM will have access to:

Resources

  • All wiki pages are exposed as resources with the URI pmwiki://Group.PageName

Tools

  1. search_wiki: Search for text across all pages

    • Parameters:
      • query (required): Text to search for
      • case_sensitive (optional): Case-sensitive search (default: false)
  2. read_page: Read the complete content of a page

    • Parameters:
      • page_name (required): Page name (e.g., Main.HomePage or Main/HomePage)
  3. list_pages: List all wiki pages

    • Parameters:
      • group (optional): Filter by group

Configuration

Wiki Directory Mount

The PmWiki directory is mounted from the host machine to the Docker container:

yaml
volumes:  - /home/docker/appdata/html/wiki.d:/wiki_data:ro

Important:

  • /home/docker/appdata/html/wiki.d is the path on the host machine - this is an example to adapt
  • Replace this path with the actual path to your PmWiki wiki.d directory
  • The volume is mounted read-only (:ro) for security reasons
  • /wiki_data is the internal container path (do not modify)

Docker Hub

The image is publicly available on Docker Hub:

  • Repository: kcofoni/pmwiki-mcp
  • Latest tag: kcofoni/pmwiki-mcp:latest
  • Stable version: kcofoni/pmwiki-mcp:v1.0.2

To pull the latest version:

bash
docker pull kcofoni/pmwiki-mcp:latest

To pull a specific version:

bash
docker pull kcofoni/pmwiki-mcp:v1.0.2

Technical Architecture

  • Language: Python 3.11
  • Web Framework: Starlette + Uvicorn
  • Protocol: MCP over SSE
  • Page Format: PmWiki (files in wiki.d/)

Logs

bash
# View logs in real-timedocker logs -f pmwiki-mcp-server
# Last 50 linesdocker logs --tail 50 pmwiki-mcp-server

Troubleshooting

Server won't start

Check that the wiki directory exists:

bash
ls -la /home/docker/appdata/html/wiki.d

404 error on a page

Use the list_pages tool to see all available pages. The exact PmWiki filename format must be used (e.g., Main.HomePage not Main/HomePage for the file).

SSE connection fails

Check that port 3000 is properly exposed:

bash
docker ps | grep pmwiki-mcp-server

Development

File Structure

pmwiki-mcp/├── pmwiki_mcp_server.py    # MCP server├── requirements.txt         # Python dependencies├── Dockerfile              # Docker image├── docker-compose.yml      # Docker Compose configuration├── README.md              # This documentation (English)└── README_fr.md           # French documentation

Code Modification

After modifying the code:

bash
docker compose up -d --build

License

This project is licensed under the MIT License - see the LICENSE file for details.

Source: README.md at commit 89fffea

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.4LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts