
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.
概覽
一個以 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 端點。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Pmwiki Mcp,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
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 communicationPOST /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:
With Docker Compose (local build)
If you want to build the image locally:
- Edit
docker-compose.ymland comment out theimage:line, then uncomment thebuild: .line - Run:
Direct Docker Usage
Without docker-compose, you can run directly:
The server will be accessible at http://localhost:3000 (or http://vmtest:3000 from other machines on the network).
Verification
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
Important notes:
vmtestis the hostname of the machine hosting the MCP server Docker container- Replace
vmtestwith:localhostif 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-proxytool 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
-
search_wiki: Search for text across all pages
- Parameters:
query(required): Text to search forcase_sensitive(optional): Case-sensitive search (default: false)
- Parameters:
-
read_page: Read the complete content of a page
- Parameters:
page_name(required): Page name (e.g.,Main.HomePageorMain/HomePage)
- Parameters:
-
list_pages: List all wiki pages
- Parameters:
group(optional): Filter by group
- Parameters:
Configuration
Wiki Directory Mount
The PmWiki directory is mounted from the host machine to the Docker container:
Important:
/home/docker/appdata/html/wiki.dis the path on the host machine - this is an example to adapt- Replace this path with the actual path to your PmWiki
wiki.ddirectory - The volume is mounted read-only (
:ro) for security reasons /wiki_datais 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:
To pull a specific version:
Technical Architecture
- Language: Python 3.11
- Web Framework: Starlette + Uvicorn
- Protocol: MCP over SSE
- Page Format: PmWiki (files in
wiki.d/)
Logs
Troubleshooting
Server won't start
Check that the wiki directory exists:
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:
Development
File Structure
Code Modification
After modifying the code:
License
This project is licensed under the MIT License - see the LICENSE file for details.
來源:README.md,提交 89fffea
工具
0版本歷史
1- v1.0.4最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分