okf-wiki-mcp 1.0.1 → 1.0.3

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 CHANGED
@@ -1,5 +1,7 @@
1
1
  # okf-wiki-mcp
2
2
 
3
+ [![okf-wiki-mcp MCP server](https://glama.ai/mcp/servers/onemira-space/okf-wiki-mcp/badges/score.svg)](https://glama.ai/mcp/servers/onemira-space/okf-wiki-mcp)
4
+
3
5
  Zero-dependency, 100% offline **Model Context Protocol (`MCP` JSON-RPC 2.0)** stdio server and CLI for querying local **Google OKF v0.2** and **Obsidian Markdown** meeting-notes vaults inside **Claude Desktop**, **Claude Code**, **Cursor**, **Windsurf**, and **OneMira**.
4
6
 
5
7
  - **Zero npm runtime dependencies** — pure Node.js `>=18` standard library (`node:fs`, `node:path`), auditable in under 350 lines.
@@ -57,8 +59,9 @@ Add to `claude_desktop_config.json` or `.cursor/mcp.json`:
57
59
  - **[`transcript-to-okf`](https://github.com/onemira-space/transcript-to-okf)** — Offline multi-vendor transcript migrator (Otter.ai, Plaud, HiNotes/HiDock, Notta, Zoom/Teams WebVTT & SRT -> OKF v0.2 Markdown).
58
60
  - **[`okf-markdown`](https://github.com/onemira-space/okf-markdown)** — OKF v0.2 schema validator & relational link linter.
59
61
  - **[`meeting-minutes-md`](https://github.com/onemira-space/meeting-minutes-md)** — 7-language (`EN/DE/FR/IT/ES/PT/KO`) agenda & meeting-minutes formatter.
60
- - **[`ai-voice-recorder-tco-dataset`](https://github.com/onemira-space/ai-voice-recorder-tco-dataset)** — CC-BY-4.0 2026 AI voice recorder spec & 24-month TCO calculator (`Compare 14+ models` at [onemira.com/compare](https://onemira.com/compare)).
62
+ - **[`ai-voice-recorder-tco-dataset`](https://github.com/onemira-space/ai-voice-recorder-tco-dataset)** — CC-BY-4.0 2026 AI voice recorder spec & 24-month TCO calculator (`Compare 20+ AI voice recorders` at [onemira.com/compare](https://onemira.com/compare)).
61
63
 
62
64
  ## License
63
65
 
64
66
  MIT © [OneMira](https://onemira.com)
67
+ - **[OneMira C1 on Amazon US (`B0HM6YDLJ4`)](https://www.amazon.com/dp/B0HM6YDLJ4)** — Standalone offline Local AI voice recorder (`$0/mo`, 30h battery, 32 GB, 85 g, 99-language Speaker ID).
@@ -18,7 +18,7 @@ function readFlag(name) {
18
18
  }
19
19
 
20
20
  if (args.includes('--help') || args.includes('-h')) {
21
- console.log(`okf-wiki-mcp v1.0.1 — Offline MCP Server & CLI for Google OKF v0.2 / Obsidian Markdown Vaults
21
+ console.log(`okf-wiki-mcp v1.0.3 — Offline MCP Server & CLI for Google OKF v0.2 / Obsidian Markdown Vaults
22
22
 
23
23
  Usage:
24
24
  okf-wiki-mcp --vault <dir> [--serve] Start stdio MCP JSON-RPC 2.0 server
@@ -33,7 +33,7 @@ Docs: https://onemira.com/docs/mcp-integration`);
33
33
  }
34
34
 
35
35
  if (args.includes('--version') || args.includes('-v')) {
36
- console.log('1.0.1');
36
+ console.log('1.0.3');
37
37
  process.exit(0);
38
38
  }
39
39
 
package/package.json CHANGED
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "okf-wiki-mcp",
3
- "version": "1.0.1",
3
+ "mcpName": "io.github.onemira-space/okf-wiki-mcp",
4
+ "version": "1.0.3",
4
5
  "description": "Zero-dependency offline Model Context Protocol (MCP) server & CLI for querying local Google OKF v0.2 and Obsidian Markdown meeting-notes vaults in Claude Desktop, Claude Code, Cursor & OneMira",
5
6
  "type": "module",
6
7
  "license": "MIT",
package/server.json CHANGED
@@ -1,27 +1,27 @@
1
1
  {
2
- "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
3
  "name": "io.github.onemira-space/okf-wiki-mcp",
4
- "description": "Zero-dependency offline MCP server for querying local Google OKF v0.2 & Obsidian Markdown meeting-notes vaults in Claude, Cursor & Windsurf.",
5
- "status": "active",
4
+ "title": "OneMira OKF & Obsidian Wiki MCP",
5
+ "description": "Offline zero-dependency MCP server for local Google OKF v0.2 & Obsidian Markdown vaults.",
6
6
  "repository": {
7
7
  "url": "https://github.com/onemira-space/okf-wiki-mcp",
8
8
  "source": "github"
9
9
  },
10
- "version": "1.0.1",
10
+ "version": "1.0.3",
11
11
  "websiteUrl": "https://onemira.com/docs/mcp-integration",
12
12
  "packages": [
13
13
  {
14
14
  "registryType": "npm",
15
15
  "identifier": "okf-wiki-mcp",
16
- "version": "1.0.1",
16
+ "version": "1.0.3",
17
17
  "transport": {
18
18
  "type": "stdio"
19
19
  },
20
20
  "environmentVariables": [
21
21
  {
22
22
  "name": "OKF_VAULT_DIR",
23
- "description": "Absolute path to your local OKF v0.2 or Obsidian Markdown meeting-notes directory.",
24
- "isRequired": true,
23
+ "description": "Optional path to your local OKF v0.2 or Obsidian Markdown meeting-notes directory (defaults to /vault in Docker or current working directory).",
24
+ "isRequired": false,
25
25
  "isSecret": false
26
26
  }
27
27
  ]
package/src/index.mjs CHANGED
@@ -279,49 +279,172 @@ export function computeVaultStats(vault) {
279
279
  export const MCP_TOOLS = [
280
280
  {
281
281
  name: 'okf_search_meetings',
282
- description: 'Search local Google OKF v0.2 and Obsidian Markdown meeting transcripts/notes by keyword, speaker, tag, and date range (100% offline).',
282
+ title: 'Search Local Meeting Notes & Transcripts',
283
+ description:
284
+ 'Search across all local Google OKF v0.2 and Obsidian Markdown meeting transcripts and notes by keyword, speaker name, tag, or ISO date range. ' +
285
+ 'Use this first for cross-vault discovery when you do not yet know the exact note path or title; prefer okf_read_note once you have a specific file path, slug, or [[wiki-link]], and prefer okf_list_action_items for task checklists. ' +
286
+ 'Read-only and 100% offline (zero network calls, no file modifications). Returns a relevance-ranked JSON array of matching notes with snippets and open action counts, or an empty array [] if no notes match.',
287
+ annotations: {
288
+ title: 'Search Local Meeting Notes & Transcripts',
289
+ readOnlyHint: true,
290
+ destructiveHint: false,
291
+ idempotentHint: true,
292
+ openWorldHint: false,
293
+ },
283
294
  inputSchema: {
284
295
  type: 'object',
296
+ additionalProperties: false,
285
297
  properties: {
286
- query: {type: 'string'},
287
- speaker: {type: 'string'},
288
- tag: {type: 'string'},
289
- fromDate: {type: 'string'},
290
- toDate: {type: 'string'},
291
- limit: {type: 'number'},
298
+ query: {
299
+ type: 'string',
300
+ description:
301
+ 'Space-separated search keywords matched case-insensitively against note titles, [[wiki-links]], and body text (e.g. "Q4 roadmap pricing"). Leave empty to filter solely by speaker, tag, or date range.',
302
+ default: '',
303
+ },
304
+ speaker: {
305
+ type: 'string',
306
+ description:
307
+ 'Case-insensitive substring filter matching YAML frontmatter speakers or inline transcript speaker labels (e.g. "Alice").',
308
+ default: '',
309
+ },
310
+ tag: {
311
+ type: 'string',
312
+ description:
313
+ 'Case-insensitive substring filter matching YAML frontmatter tags (e.g. "local-ai" or "roadmap").',
314
+ default: '',
315
+ },
316
+ fromDate: {
317
+ type: 'string',
318
+ description:
319
+ 'Inclusive lower-bound ISO-8601 date filter (YYYY-MM-DD, e.g. "2026-11-01"). Notes without a date field are retained unless excluded by other filters.',
320
+ default: '',
321
+ },
322
+ toDate: {
323
+ type: 'string',
324
+ description:
325
+ 'Inclusive upper-bound ISO-8601 date filter (YYYY-MM-DD, e.g. "2026-11-30").',
326
+ default: '',
327
+ },
328
+ limit: {
329
+ type: 'integer',
330
+ description:
331
+ 'Maximum number of ranked meeting notes to return (clamped between 1 and 50).',
332
+ default: 10,
333
+ minimum: 1,
334
+ maximum: 50,
335
+ },
292
336
  },
293
337
  },
294
338
  },
295
339
  {
296
340
  name: 'okf_list_action_items',
297
- description: 'Extract open or completed Markdown task items (- [ ] / - [x]) and @owner assignments across local meeting notes.',
341
+ title: 'List Meeting Action Items',
342
+ description:
343
+ 'Extract Markdown task checklist items (- [ ] open or - [x] completed) and @owner / bold-owner assignments across all local meeting notes in the vault. ' +
344
+ 'Use this for follow-up tracking, standups, and accountability reviews; prefer okf_search_meetings for general topic search or okf_read_note for full meeting context around a task. ' +
345
+ 'Read-only and 100% offline. Returns a JSON array of action item objects containing file, line, completed, owner, text, title, and date, or [] when none match.',
346
+ annotations: {
347
+ title: 'List Meeting Action Items',
348
+ readOnlyHint: true,
349
+ destructiveHint: false,
350
+ idempotentHint: true,
351
+ openWorldHint: false,
352
+ },
298
353
  inputSchema: {
299
354
  type: 'object',
355
+ additionalProperties: false,
300
356
  properties: {
301
- status: {type: 'string', enum: ['open', 'completed', 'all']},
302
- owner: {type: 'string'},
303
- limit: {type: 'number'},
357
+ status: {
358
+ type: 'string',
359
+ enum: ['open', 'completed', 'all'],
360
+ description:
361
+ 'Filter checklist items by completion state: "open" for unchecked (- [ ]), "completed" for checked (- [x]), or "all" for both.',
362
+ default: 'open',
363
+ },
364
+ owner: {
365
+ type: 'string',
366
+ description:
367
+ 'Case-insensitive substring filter matching the extracted @owner or **Owner**: assignee (e.g. "Alice"). Leave empty to include unassigned and all owners.',
368
+ default: '',
369
+ },
370
+ limit: {
371
+ type: 'integer',
372
+ description:
373
+ 'Maximum number of action items to return (clamped between 1 and 200).',
374
+ default: 50,
375
+ minimum: 1,
376
+ maximum: 200,
377
+ },
304
378
  },
305
379
  },
306
380
  },
307
381
  {
308
382
  name: 'okf_read_note',
309
- description: 'Read a specific local OKF/Obsidian Markdown note by path, slug, or [[wiki-link]], including frontmatter and incoming backlinks.',
383
+ title: 'Read Local OKF Note with Backlinks',
384
+ description:
385
+ 'Read the complete Markdown content, parsed YAML frontmatter, outgoing [[wiki-links]], incoming backlinks, and extracted action items for a single known note. ' +
386
+ 'Use this after discovering a note via okf_search_meetings, okf_list_action_items, or okf_topic_graph; do not use it for fuzzy keyword search across multiple files. ' +
387
+ 'Read-only and 100% offline. Returns a structured JSON note object, or sets isError: true with a "Note not found" message if no file path, slug, or title matches target.',
388
+ annotations: {
389
+ title: 'Read Local OKF Note with Backlinks',
390
+ readOnlyHint: true,
391
+ destructiveHint: false,
392
+ idempotentHint: true,
393
+ openWorldHint: false,
394
+ },
310
395
  inputSchema: {
311
396
  type: 'object',
397
+ additionalProperties: false,
312
398
  required: ['target'],
313
- properties: {target: {type: 'string'}},
399
+ properties: {
400
+ target: {
401
+ type: 'string',
402
+ description:
403
+ 'Exact relative file path (e.g. "2026-11-15-architecture-sync.md"), filename slug (e.g. "local-ai-pipeline"), note title, or [[wiki-link]] reference (e.g. "[[Local AI Pipeline]]").',
404
+ minLength: 1,
405
+ },
406
+ },
314
407
  },
315
408
  },
316
409
  {
317
410
  name: 'okf_topic_graph',
318
- description: 'Build the relational [[wiki-link]] topic graph and list unresolved links across the local Markdown vault.',
319
- inputSchema: {type: 'object', properties: {}},
411
+ title: 'Build Relational Wiki-Link Topic Graph',
412
+ description:
413
+ 'Compute the directed [[wiki-link]] knowledge graph across all Markdown notes in the local vault, ranking the most referenced topics and identifying unresolved (dangling) wiki-links. ' +
414
+ 'Use this to map recurring entities/projects or audit broken links; prefer okf_vault_stats for high-level aggregate counts or okf_read_note to inspect one topic page. ' +
415
+ 'Read-only and 100% offline. Takes no parameters and returns JSON with totalNotes, totalEdges, topTopics, unresolvedLinks, and edges.',
416
+ annotations: {
417
+ title: 'Build Relational Wiki-Link Topic Graph',
418
+ readOnlyHint: true,
419
+ destructiveHint: false,
420
+ idempotentHint: true,
421
+ openWorldHint: false,
422
+ },
423
+ inputSchema: {
424
+ type: 'object',
425
+ additionalProperties: false,
426
+ properties: {},
427
+ },
320
428
  },
321
429
  {
322
430
  name: 'okf_vault_stats',
323
- description: 'Audit vault health: total notes, YAML frontmatter coverage, unique speakers, wiki-link edges, and open/completed action items.',
324
- inputSchema: {type: 'object', properties: {}},
431
+ title: 'Audit Local Vault Health & Statistics',
432
+ description:
433
+ 'Summarize overall vault health and inventory: total Markdown notes, YAML frontmatter coverage, unique speaker list, total and unresolved [[wiki-link]] counts, and open vs completed action-item totals. ' +
434
+ 'Use this first to orient on a vault before running targeted okf_search_meetings or okf_list_action_items queries. ' +
435
+ 'Read-only and 100% offline. Takes no parameters and returns a single JSON summary object (zeros when the vault directory is empty).',
436
+ annotations: {
437
+ title: 'Audit Local Vault Health & Statistics',
438
+ readOnlyHint: true,
439
+ destructiveHint: false,
440
+ idempotentHint: true,
441
+ openWorldHint: false,
442
+ },
443
+ inputSchema: {
444
+ type: 'object',
445
+ additionalProperties: false,
446
+ properties: {},
447
+ },
325
448
  },
326
449
  ];
327
450
 
@@ -338,7 +461,7 @@ export function handleMcpRequest(vaultDir, msg) {
338
461
  result: {
339
462
  protocolVersion: params?.protocolVersion || '2024-11-05',
340
463
  capabilities: {tools: {}, resources: {}},
341
- serverInfo: {name: 'okf-wiki-mcp', version: '1.0.1'},
464
+ serverInfo: {name: 'okf-wiki-mcp', version: '1.0.3'},
342
465
  },
343
466
  };
344
467
  }