@mfdaves/okf-mcp 0.9.0 → 0.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -8
- package/package.json +1 -1
- package/server.json +2 -2
package/README.md
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
# okf-mcp
|
|
2
2
|
|
|
3
|
-
`okf-mcp`
|
|
3
|
+
`okf-mcp` publishes [Open Knowledge Format v0.2](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md) from the systems that already hold the knowledge, and serves the result to agents. It is a local-first consumer, validator, graph index, CLI, and MCP server.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
The part that is hard is writing to a catalog safely. A configured producer reads an external source and returns a candidate bundle; okf-mcp validates it, then publishes it under an ownership manifest that records exactly which files it owns. Hand-authored content is never adopted, a source that did not change rewrites nothing, and no producer output escapes its bundle. [`@mfdaves/okf-postgres`](https://github.com/mfdaves/okf-postgres) reads PostgreSQL catalogs this way without reading a single table row.
|
|
6
|
+
|
|
7
|
+
Reading is the ordinary half. It consumes an OKF bundle directory of Markdown files with YAML frontmatter. An optional workspace mode can federate several bundles. Concepts are exposed through CLI commands and MCP resources and tools for validation, structured search, graph navigation, provenance inspection, and proposal-based authoring.
|
|
6
8
|
|
|
7
9
|
The core intentionally has no database, embeddings, build step, or hosted-service dependency. It uses `js-yaml` for safe YAML, CommonMark for Markdown structure, MiniSearch for in-memory BM25+ text retrieval, and the official Model Context Protocol TypeScript SDK v2 for stdio MCP. Local root mode makes no network calls. Optional remote loading fetches public Markdown concepts and only their explicitly referenced inert assets from GitHub. Nothing in the v0.2 computation support executes code or attests a receipt.
|
|
8
10
|
|
|
@@ -35,7 +37,7 @@ Node 22 or newer is required.
|
|
|
35
37
|
Install from the GitHub release:
|
|
36
38
|
|
|
37
39
|
```bash
|
|
38
|
-
git clone --branch v0.9.
|
|
40
|
+
git clone --branch v0.9.1 https://github.com/mfdaves/okf-mcp.git
|
|
39
41
|
cd okf-mcp
|
|
40
42
|
npm ci
|
|
41
43
|
node bin/okf-mcp.js --root ./path/to/okf validate
|
|
@@ -44,14 +46,14 @@ node bin/okf-mcp.js --root ./path/to/okf validate
|
|
|
44
46
|
Pin the published version for reproducible use:
|
|
45
47
|
|
|
46
48
|
```bash
|
|
47
|
-
npx -y @mfdaves/okf-mcp@0.9.
|
|
48
|
-
npx -y @mfdaves/okf-mcp@0.9.
|
|
49
|
+
npx -y @mfdaves/okf-mcp@0.9.1 --version
|
|
50
|
+
npx -y @mfdaves/okf-mcp@0.9.1 --root ./path/to/okf validate
|
|
49
51
|
```
|
|
50
52
|
|
|
51
53
|
For a persistent installation:
|
|
52
54
|
|
|
53
55
|
```bash
|
|
54
|
-
npm install --global @mfdaves/okf-mcp@0.9.
|
|
56
|
+
npm install --global @mfdaves/okf-mcp@0.9.1
|
|
55
57
|
|
|
56
58
|
okf --version
|
|
57
59
|
okf --root ./path/to/okf validate
|
|
@@ -237,7 +239,7 @@ Example client configuration:
|
|
|
237
239
|
"command": "npx",
|
|
238
240
|
"args": [
|
|
239
241
|
"-y",
|
|
240
|
-
"@mfdaves/okf-mcp@0.9.
|
|
242
|
+
"@mfdaves/okf-mcp@0.9.1",
|
|
241
243
|
"--root",
|
|
242
244
|
"/absolute/path/to/okf",
|
|
243
245
|
"mcp"
|
|
@@ -256,7 +258,7 @@ Project config mode, with read-only project helpers but without proposal mutatio
|
|
|
256
258
|
"command": "npx",
|
|
257
259
|
"args": [
|
|
258
260
|
"-y",
|
|
259
|
-
"@mfdaves/okf-mcp@0.9.
|
|
261
|
+
"@mfdaves/okf-mcp@0.9.1",
|
|
260
262
|
"--project",
|
|
261
263
|
"/absolute/path/to/repo/okf.project.yaml",
|
|
262
264
|
"mcp"
|
package/package.json
CHANGED
package/server.json
CHANGED
|
@@ -8,12 +8,12 @@
|
|
|
8
8
|
"source": "github"
|
|
9
9
|
},
|
|
10
10
|
"websiteUrl": "https://github.com/mfdaves/okf-mcp#readme",
|
|
11
|
-
"version": "0.9.
|
|
11
|
+
"version": "0.9.1",
|
|
12
12
|
"packages": [
|
|
13
13
|
{
|
|
14
14
|
"registryType": "npm",
|
|
15
15
|
"identifier": "@mfdaves/okf-mcp",
|
|
16
|
-
"version": "0.9.
|
|
16
|
+
"version": "0.9.1",
|
|
17
17
|
"transport": {
|
|
18
18
|
"type": "stdio"
|
|
19
19
|
},
|