| name | okf-mcp |
| description | Generic Model Context Protocol (MCP) server that discovers installed okf-* skill binaries and exposes their produce/ingest commands as MCP tools for any MCP-capable harness (Claude Code, Gemini CLI, etc.). Use when wiring OKF Skills into an agent over MCP instead of invoking each connector binary directly. |
| license | Apache-2.0 |
| compatibility | Requires the Go toolchain (1.24+) to build the server binary, plus installed okf-* skill binaries to discover and expose. |
| metadata | {"version":"0.8.0","author":"Yurii Serhiichuk","tags":"okf, mcp, registry, tools"} |
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 .
Running
okf-mcp
okf-mcp --skills-dir ./bin
okf-mcp --timeout 2m
Diagnostics are written to stderr; stdout is the MCP protocol channel.
Configuring a harness
Point any MCP client at the okf-mcp command over stdio. Example (generic MCP client config):
{
"mcpServers": {
"okf": { "command": "okf-mcp", "args": ["--skills-dir", "/path/to/okf/bin"] }
}
}