OKF MCP Server

okf-mcp is a generic Model Context Protocol server. On startup it discovers installed okf-* skill binaries, runs <skill> schema on each, and exposes every skill command (except schema itself) as an MCP tool named <skill>__<command> (e.g. okf-sqlite__produce). Any MCP-capable harness can then drive all of OKF Skills without per-skill glue.

How it works

Discovery — scans --skills-dir, else $OKF_SKILLS_DIR, else every $PATH entry, for okf-* executables.
Reflection — reads each skill's machine-readable schema output and turns its flags into a JSON-Schema tool input.
Invocation — a tool call is translated back into the skill's CLI (<command> --flag value ...) and run with a per-call timeout. Flags that advertise an env binding (e.g. database passwords) are passed via the child environment, never argv. The skill's stdout is returned as the tool result.

Install

Install the published server binary (Go 1.24+) — no clone needed:

go install github.com/xSAVIKx/okf-skills/okf-mcp@v0.1.0

This drops an okf-mcp binary into $(go env GOPATH)/bin. Alternatively, build from a clone: cd okf-mcp && go build -o okf-mcp .