OKF4net.Mcp 0.2.0

OKF4net.Mcp

A local Model Context Protocol server that exposes one OKF knowledge bundle to Claude Desktop / Claude Code as read/write tools — the same way an Obsidian MCP server exposes a vault.

Install

dotnet tool install -g OKF4net.Mcp

This installs the okf-mcp command.

Use with Claude Desktop

Add an entry to claude_desktop_config.json:

{
  "mcpServers": {
    "okf": {
      "command": "okf-mcp",
      "args": ["C:\\path\\to\\my-bundle"]
    }
  }
}

The bundle root may instead be supplied via the environment:

{
  "mcpServers": {
    "okf": {
      "command": "okf-mcp",
      "env": { "OKF_BUNDLE_ROOT": "/path/to/my-bundle", "OKF_MCP_READONLY": "1" }
    }
  }
}

Set OKF_MCP_READONLY=1 to serve the bundle for consultation only (the write tools okf_write_concept, okf_append_log, okf_regenerate_indexes are not registered).

Tools

okf_read_concept, okf_browse, okf_graph, okf_search, okf_write_concept, okf_append_log, okf_regenerate_indexes, okf_validate_bundle, okf_changes_since.

Each is the corresponding OkfBundleTools operation, so all OKF v0.1 behaviour, producer-grade validation, path-safety, and locking apply unchanged.