GoogleCloudPlatform / GoogleCloudPlatform/knowledge-catalog

Community tooling: okft — OKF bundle linter + MCP server

Open
#196 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
9.2k
Forks
782
Avg merge
6h 36m
Merged PRs (30d)
85

Description

Hi! I built [okft](https://github.com/PoorvaJ-WW/okft) (`pip install okft`), an Apache-2.0 CLI for OKF v0.1 bundles:

- `okft lint` — spec-conformance checks (frontmatter, `type`, reserved files) plus hygiene warnings (unresolved links, orphaned concepts, timestamps). CI-friendly exit codes and JSON output. Broken links are warnings, not errors, per the spec's tolerance requirement.
- `okft serve` — an MCP server exposing a bundle to any MCP-capable agent as deterministic navigation tools (overview / read / search / list), following links rather than embeddings.

If you keep a list of community tooling, I'd love for it to be included — and happy to adjust anything to track the spec as it evolves.

Contributor guide

Open the contributing guide

Research direction

Start by locating the repository's list of community tooling; the issue provides the okft project link, install command, capabilities, and license to use as source material. Confirm how similar tools are listed, then add okft with an accurate description and link. Done means the community tooling list includes the project without overstating its support for the evolving spec.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
56/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.