okf-mcp — Claude Code MCP server: what it does, how to install
okf-mcp is an MCP server for coding agents that validates Open Knowledge Format v0.2 bundles, builds a link graph, and searches their contents.
MIT ★ 8 updated 2026-09-19
claude mcp add okf-mcp -- npx -y @mfdaves/okf-mcpWhat okf-mcp does
okf-mcp exposes Open Knowledge Format v0.2 directories to coding assistants. It scans Markdown files with YAML frontmatter, builds a graph of cross-references, and provides in-memory BM25+ text search via MiniSearch. The core works without vector databases, remote cloud endpoints, or compilation steps.
When external producers create documentation bundles, okf-mcp applies ownership manifests. Hand-written files stay untouched, and automated generators cannot step outside their target folder. The tool inspects execution contracts purely at the syntax level and will never execute referenced source files.
Running the package requires Node 22 or higher. In standard single-root setups, the server operates entirely offline over stdio.
What it helps with
- expose local OKF v0.2 documentation trees to AI coding assistants
- perform in-memory BM25+ searches across project notes without vector stores
- validate concept schemas and cross-reference links inside Markdown bundles
- prevent automated catalog generators from overwriting hand-crafted notes
Example prompts for the agent
- Search the local OKF bundle for concepts related to authorization
- Validate the structure and links of all files in
./knowledge-base - Inspect the provenance and dependency graph for
overview/okf-mcp
How to install okf-mcp
Platform CLI
claude mcp add okf-mcp -- npx -y @mfdaves/okf-mcpPlatform CLI
codex mcp add okf-mcp -- npx -y @mfdaves/okf-mcpConfig file
{
"mcpServers": {
"okf-mcp": {
"command": "npx",
"args": [
"-y",
"@mfdaves/okf-mcp"
]
}
}
}Config file
{
"servers": {
"okf-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mfdaves/okf-mcp"
]
}
}
}Platform CLI
gemini mcp add okf-mcp npx -y @mfdaves/okf-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about okf-mcp
How to install okf-mcp in Claude Code?
Register the server by running claude mcp add okf-mcp -- npx -y @mfdaves/okf-mcp.
What does okf-mcp do?
It provides tools and resources for agents to search, validate, and navigate local Open Knowledge Format Markdown catalogs.
Does okf-mcp execute external code referenced in concepts?
No. The server only performs static checks on contracts and metadata, keeping all referenced assets inert without running scripts.