Pmwiki Mcp

io.github.kcofoni由 GitHub 帳號 kcofoni 發布v1.0.4更新於 Oct 24, 2026

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

已驗證STDIO僅桌面檔案與儲存知識與記憶

概覽

AI 產生的概覽

一個以 Docker 執行的本機 MCP 伺服器,讓助理搜尋、列出並讀取 PmWiki wiki.d 目錄中的頁面。

可以做什麼
以文字搜尋所有 wiki 頁面,可選擇區分大小寫。列出全部 wiki 頁面,並可依群組篩選。讀取指定頁面的完整內容,例如 Main.HomePage。將每個 wiki 頁面公開為資源,以群組與頁面名稱定址。
適用情境
適合讓助理根據既有 PmWiki 網站回答問題、查找或引用頁面內容,或瀏覽 wiki 的群組,而不進行編輯。它為唯讀,適合檢索與參考用途,而非撰寫內容。
執行需求
以本機 Docker 容器執行(映像 kcofoni/pmwiki-mcp),透過 SSE 開放 3000 埠;必須設定 WIKI_DIR 環境變數指向 PmWiki 的 wiki.d 目錄,並以唯讀方式掛載。需要 mcp-proxy 之類的用戶端代理,才能讓 Claude Desktop 連上 SSE 端點。
安裝前請注意
伺服器會讀取掛載進容器的 wiki.d 目錄,因此只應開放你願意讓助理存取的目錄;README 建議使用唯讀掛載。3000 埠的 SSE 端點未宣告任何身分驗證,網路上能存取它的人都能查詢該 wiki。未描述寫入、傳送或刪除類工具。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Pmwiki Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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.

來源:README.md,提交 89fffea

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.0.4最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分