Pmwiki MCP

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

Verification

# Check that the server is running

docker logs pmwiki-mcp-server

Test the SSE connection

curl -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

{

"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)

1. read_page: Read the complete content of a page

• Parameters:
• page_name (required): Page name (e.g., Main.HomePage or Main/HomePage)

1. 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:

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:

docker pull kcofoni/pmwiki-mcp:latest

To pull a specific version:

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

# View logs in real-time

docker logs -f pmwiki-mcp-server

Last 50 lines

docker logs --tail 50 pmwiki-mcp-server

Troubleshooting

Server won't start

Check that the wiki directory exists:

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:

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:

docker compose up -d --build

License

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