ojob ojob.io/ai/mcps/mcp-wiki onport=8888 wikibackend=fs wikiroot=./wiki wikibucket=my-wiki-bucket wikiprefix=wiki/ wikiurl=https://s3.amazonaws.com wikiaccesskey= wikisecret= wikiregion= wikiuseversion1=false wikiignorecertcheck=false wikis3artifactprefix=wiki-artifacts/ s3artifactbundle= wikihttpindexurl= wikihttptimeout= wikiartifactrefreshsecs=300 wikiindexdir=/var/cache/mini-a/wiki wikilexical="{ language: 'english', synonymsFile: 'synonyms.txt' }" wikisourceurl="https://docs.example.com/{{$encodePath pathNoExt}}" wikisourcefield=sourceUrl wikisourceinline=false toolPrefix=wiki- label="Team wiki" wikimounts="[{name: 'team', backend: 'fs', root: './team-wiki'}]" usewikigraph=false wikigraphfalkorhost= wikigraphfalkorport=6379 wikigraphfalkorgraph=mini_a_wiki wikigraphfalkoruser= wikigraphfalkorpass= wikigraphsearchhints=true wikigraphhintcap=5 wikigraphcross=true wikigraphcrossjoin=link,tag,alias,concept wikigraphcrosscap=5 wikigraphcrossdepth=1 wikigraphcrossmaxdf=0.25 wikigraphcrossminkeylen=3 audit=false A standalone STDIO/HTTP MCP wiki knowledge base server (read-only)
| Name | Description |
|---|---|
| onport | If defined starts an HTTP MCP server on this port; otherwise uses STDIO |
| wikibackend | Wiki backend type (fs, s3, s3fs, es or http; https is an alias) |
| wikiroot | Base directory or local .zip/.okt archive for fs backend (archives are always read-only) |
| wikibucket | S3 bucket for s3 backend |
| wikiprefix | S3 key prefix for s3/s3fs backend, or Elasticsearch index for es backend |
| wikiurl | S3 endpoint for s3/s3fs, Elasticsearch/OpenSearch base URL for es, or static wiki base URL for http |
| wikiaccesskey | S3 access key, or Elasticsearch username for es backend |
| wikisecret | S3 secret key, or Elasticsearch password for es backend |
| wikiregion | S3 region |
| wikiuseversion1 | Force S3 signature version 1 |
| wikiignorecertcheck | Ignore TLS cert validation on S3 endpoint |
| wikis3artifactprefix | Optional S3 prefix containing a published local wiki cache (.mini-a-wiki-lucene/ and .mini-a-wiki-graph/graph.json). It is downloaded to wikiindexdir at startup. |
| s3artifactbundle | Use <prefix>/mini-a-wiki-index.zip instead of individual S3 artifact objects |
| wikihttpindexurl | Optional HTTP artifact bundle URL (defaults to <wikiurl>/mini-a-wiki-index.zip) |
| wikihttptimeout | HTTP wiki request timeout in milliseconds (default 30000) |
| wikiartifactrefreshsecs | Recheck an HTTP or bundled-S3 artifact cache after this many seconds between wiki requests (0 disables; default 0) |
| wikiindexdir | Local cache directory used for downloaded S3 search and graph artifacts |
| wikilexical | SLON/JSON Lucene lexical configuration. Defaults to {language: 'english'}; supports inline synonyms and an optional synonymsFile. |
| wikisourceurl | Optional Handlebars template rendering a page's canonical citation URL (e.g. its published docs site). Available: path, pathNoExt, encodedPath, backend, root, bucket, prefix, url, mount, section, anchor, title. addOpenAFHelpers/addConditionalHelpers plus $encodeURI/$encodeURIComponent/$encodePath are registered; percent-encoding via {{$encodePath …}} is recommended over triple-brace escaping. A wikimounts entry may set its own wikisourceurl. Not applicable to mcp-wiki-safe.yaml's restricted retrieval, which hides real page paths. |
| wikisourcefield | Result field name the rendered citation URL is written to |
| wikisourceinline | Also append the rendered URL into search results' description/summary text, for models that attend to prose more reliably than to sibling JSON keys |
| toolPrefix | Optional prefix prepended to all tool names (e.g. "docs-" -> docs-list, docs-read, …) |
| label | Human-readable wiki label injected into templated tool descriptions |
| wikimounts | SLON/JSON array of read-only wiki mounts: [{name, backend, root |
| usewikigraph | Enable the wiki knowledge graph. Also enabled automatically when `wikigraphfalkorhost` is provided. Search transparently appends related-page hints. |
| wikigraphfalkorhost | FalkorDB host for graph-backed wiki state and queries. Also enables the wiki graph automatically. |
| wikigraphfalkorport | FalkorDB port |
| wikigraphfalkorgraph | FalkorDB graph name |
| wikigraphfalkoruser | FalkorDB username |
| wikigraphfalkorpass | FalkorDB password |
| wikigraphsearchhints | Append graph-related pages to search results when the wiki graph is enabled |
| wikigraphhintcap | Maximum graph-hint pages appended to search results |
| wikigraphcross | Join this wiki's graph with mounted wikis' graphs at query time (explicit @-links, shared tags/aliases/concepts). Requires wikigraphmounts. |
| wikigraphcrossjoin | CSV of enabled cross-wiki join kinds: link,tag,alias,concept |
| wikigraphcrosscap | Maximum cross-wiki entries appended per query |
| wikigraphcrossdepth | Cross-wiki traversal depth: 1 resolves explicit links, 2 also pulls the target's in-mount related pages |
| wikigraphcrossmaxdf | Skip a shared tag/alias/concept join key present on more than this fraction of a mount's docs |
| wikigraphcrossminkeylen | Minimum length for a shared join key to be used for cross-wiki matching |
| audit | If true (or env OJOB_MCP_AUDIT), logs every MCP tool call (tool name and arguments, handled generically by oJobMCP.yaml) plus every page actually fetched from a remote wikibackend (s3, http, es) -- backend, resolved location (s3://bucket/key, URL, or es:index/path), and byte count -- via OpenAF's log() function. The latter also covers pages fetched internally while serving search/lint/list, not just the top-level read tool call. |