Fit Wiki
Model Context Protocol server and CLI for FIT Wiki.
Ask AI about Fit Wiki
Powered by Claude · Grounded in docs
I know everything about Fit Wiki. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
FIT Wiki MCP
Model Context Protocol server and CLI for FIT Wiki. Public pages work without auth; logged-in pages use DokuWiki cookies stored in the OS credential store.
Install
npm install -g fit-wiki-mcp
Local development:
npm install
npm run build
npm test
Requires Node.js 22.13 or newer. PDF page rendering uses PDF.js with the native @napi-rs/canvas backend pulled transitively by pdfjs-dist.
Optional live regression tests hit FIT Wiki directly. Public smoke tests always run; authenticated DML page/file/PDF checks run when FITWIKI_COOKIE, both credential env vars, or a local keychain login is available:
FITWIKI_TEST_USERNAME=... FITWIKI_TEST_PASSWORD=... npm run test:live
Login
No manual browser-cookie copying. Login through the CLI:
npx -y fit-wiki-mcp@latest auth login --username YOUR_FIT_WIKI_USERNAME
Password is prompted hidden, posted once to FIT Wiki, and never stored. The returned DokuWiki cookie is stored in the OS credential store:
- macOS: Keychain
- Windows: Credential Manager
- Linux: Secret Service/libsecret
Check or delete local auth:
npx -y fit-wiki-mcp@latest auth status
npx -y fit-wiki-mcp@latest auth logout
FITWIKI_COOKIE still works as an env override for CI or debugging.
MCP Config
After global install:
{
"mcpServers": {
"fit-wiki": {
"command": "fit-wiki-mcp"
}
}
}
Without global install:
{
"mcpServers": {
"fit-wiki": {
"command": "npx",
"args": ["-y", "fit-wiki-mcp@latest"]
}
}
}
opencode config uses the same local MCP command:
{
"mcp": {
"fit-wiki": {
"type": "local",
"enabled": true,
"command": ["npx", "-y", "fit-wiki-mcp@latest"]
}
}
}
Optional env:
{
"env": {
"FITWIKI_BASE_URL": "https://fit-wiki.cz",
"FITWIKI_COOKIE": "DokuWiki=...; DW..."
}
}
Tools
fitwiki_search: live DokuWiki search.fitwiki_read_page: read page by id/URL as markdown, raw wiki syntax, or clean HTML. Use file/PDF tools too when diagrams, scans, or embedded figures matter.fitwiki_list_index: list visible index namespaces/pages.fitwiki_find_files: find images, PDFs, and downloadable files linked from a page.fitwiki_get_file: download same-origin media/files. Raster images return MCP image content, SVGs return rendered PNG image content, PDFs/files return embedded binary resource blobs.fitwiki_pdf_info: inspect a PDF's page count, labels, outline, and metadata.fitwiki_pdf_page_text: extract text from one PDF page.fitwiki_pdf_page_image: render one PDF page as MCPimage/png; prefer this for diagrams, scans, formulas, tables, and layout-dependent answers.fitwiki_export_pdf: export a page as PDF when visual layout, formulas, diagrams, or embedded images matter.fitwiki_auth_check: verify current auth source.
Binary responses are capped at 10 MB.
PDF tools cache downloaded files under the OS temp directory by default for 1 hour, capped at 50 MB. Override with FITWIKI_CACHE_DIR, FITWIKI_CACHE_TTL_MS, FITWIKI_CACHE_MAX_BYTES, or disable with FITWIKI_CACHE_DISABLED=1.
License
Code is licensed under AGPL-3.0-or-later.
FIT Wiki footer says content is licensed as CC BY-NC-SA 4.0 unless a page says otherwise. This server returns source URLs and license metadata where relevant.
