@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.
Files changed (3) hide show
  1. package/README.md +10 -8
  2. package/package.json +1 -1
  3. package/server.json +2 -2
package/README.md CHANGED
@@ -1,8 +1,10 @@
1
1
  # okf-mcp
2
2
 
3
- `okf-mcp` is a local-first consumer, validator, graph index, CLI, and MCP server for [Open Knowledge Format v0.2](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md).
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
- 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.
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.0 https://github.com/mfdaves/okf-mcp.git
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.0 --version
48
- npx -y @mfdaves/okf-mcp@0.9.0 --root ./path/to/okf validate
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.0
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.0",
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.0",
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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mfdaves/okf-mcp",
3
- "version": "0.9.0",
3
+ "version": "0.9.1",
4
4
  "description": "Local-first Open Knowledge Format validator, graph index, CLI, and MCP stdio server.",
5
5
  "homepage": "https://github.com/mfdaves/okf-mcp#readme",
6
6
  "repository": {
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.0",
11
+ "version": "0.9.1",
12
12
  "packages": [
13
13
  {
14
14
  "registryType": "npm",
15
15
  "identifier": "@mfdaves/okf-mcp",
16
- "version": "0.9.0",
16
+ "version": "0.9.1",
17
17
  "transport": {
18
18
  "type": "stdio"
19
19
  },