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 +4 -1
- package/bin/okf-wiki-mcp.mjs +2 -2
- package/package.json +2 -1
- package/server.json +7 -7
- package/src/index.mjs +141 -18
package/README.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# okf-wiki-mcp
|
|
2
2
|
|
|
3
|
+
[](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
|
|
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).
|
package/bin/okf-wiki-mcp.mjs
CHANGED
|
@@ -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.
|
|
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.
|
|
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
|
-
"
|
|
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-
|
|
2
|
+
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
3
|
"name": "io.github.onemira-space/okf-wiki-mcp",
|
|
4
|
-
"
|
|
5
|
-
"
|
|
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.
|
|
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.
|
|
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": "
|
|
24
|
-
"isRequired":
|
|
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
|
-
|
|
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: {
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
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
|
-
|
|
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: {
|
|
302
|
-
|
|
303
|
-
|
|
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
|
-
|
|
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: {
|
|
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
|
-
|
|
319
|
-
|
|
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
|
-
|
|
324
|
-
|
|
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.
|
|
464
|
+
serverInfo: {name: 'okf-wiki-mcp', version: '1.0.3'},
|
|
342
465
|
},
|
|
343
466
|
};
|
|
344
467
|
}
|