About

Imported from xSAVIKx/okf-skills (okf-mcp/SKILL.md). Install upstream with npx skills add xSAVIKx/okf-skills --skill okf-mcp. Copyright stays with the author (Apache-2.0).

OKF MCP Server

Name: okf-mcp
Author: xSAVIKx

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                      # discover skills on PATH, serve over stdio
okf-mcp --skills-dir ./bin   # discover skills in a specific directory
okf-mcp --timeout 2m         # per-invocation timeout (default 5m)

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"] }
  }
}

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/xsavikx-okf-skills-okf-mcp/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

xsavikx-okf-skills-okf-mcp.ocm.jsonjson

{
  "ocm": "1",
  "id": "xsavikx-okf-skills-okf-mcp",
  "kind": "skill",
  "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.",
  "publisher": "xSAVIKx",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "okf",
      "mcp",
      "registry",
      "tools",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "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."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/xSAVIKx/okf-skills",
      "path": "okf-mcp/SKILL.md",
      "ref": "234d250ba4d36d594af4fe069d426afb58b610c7",
      "url": "https://github.com/xSAVIKx/okf-skills/blob/234d250ba4d36d594af4fe069d426afb58b610c7/okf-mcp/SKILL.md",
      "key": "xSAVIKx/okf-skills/okf-mcp/SKILL.md"
    },
    "compatibility": "Requires the Go toolchain (1.24+) to build the server binary, plus installed okf-* skill binaries to discover and expose.",
    "license": "Apache-2.0"
  },
  "instructions": "# OKF MCP Server\n\n`okf-mcp` is a generic [Model Context Protocol](https://modelcontextprotocol.io) 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.\n\n## How it works\n\n1. **Discovery** — scans `--skills-dir`, else `$OKF_SKILLS_DIR`, else every `$PATH` entry, for `okf-*` executables.\n2. **Reflection** — reads each skill's machine-readable `sch",
  "cost": {
    "context_tokens": 449
  }
}

Fetch it by URL: GET /api/v1/registry/xsavikx-okf-skills-okf-mcp/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.