Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add okf-mcp -- npx -y @mfdaves/okf-mcp
Open on GitHub

What 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-mcp

Step 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open