oscar64-mcp-docs 0.1.1 → 0.1.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.
Files changed (3) hide show
  1. package/README.md +6 -11
  2. package/dist/stdio.js +761 -484
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -7,11 +7,12 @@ Local MCP server (Mastra + stdio) exposing Oscar64 documentation and tutorial co
7
7
  - HTTP-only source syncing (no git dependency)
8
8
  - 24h stale checks with remote SHA + local zip hash detection
9
9
  - Anchored manual retrieval (`docs://oscar64/manual#...`)
10
- - Tutorial manifests generated from folder structure and source previews
10
+ - Tutorial metadata generated from folder structure and source previews
11
11
  - Generic concept classifier with evidence + concept-derived categories
12
12
  - MiniSearch-powered doc/tutorial relevance search
13
- - Scoped code search (`tutorials`, `sdk`, `samples`, `autotest`, `compiler`)
14
- - Contract-first MCP tool responses with explicit `next_actions`
13
+ - Ranked code search across all exposed sources
14
+ - Minimal MCP tool responses (`ok` + `data`/`error`)
15
+ - Single canonical file exposure policy (`.c`, `.h`, `.cpp`, `.s`, `.asm`, `.inc`, `.md`, `.txt`)
15
16
  - LLM guidance resources (`index://quickstart`, `index://tooling-guide`, `index://contracts`, `index://errors`)
16
17
 
17
18
  ## Development
@@ -53,20 +54,14 @@ The executable entry is built to `dist/stdio.js`.
53
54
 
54
55
  Primary tools:
55
56
 
56
- - `search_docs(query, limit, scope)` -> ranked doc/tutorial hits with `uri`, `title`, `snippet`
57
- - `get_doc_section(anchor_or_heading, max_chars)` -> resolved manual section content
58
- - `search_code(query, scope, path_glob, limit)` -> code snippets with `line_start`, `line_end`, `uri`
59
- - `get_best_tutorial(task, limit)` -> ranked tutorial manifests with concepts and evidence
60
- - `refresh_sources(force)` -> refresh HTTP snapshots
61
- - `get_source_status()` -> source readiness and index sizes
57
+ - `search(query, limit)` -> unified doc/tutorial/code search with strict fields (doc/tutorial hits include `title`, `snippet`; code hits include `line_start`, `line_end`, `snippet`)
58
+ - `read_uri(uri, binary_mode, max_base64_bytes)` -> strict text/binary read response for any URI returned by `search`
62
59
 
63
60
  Standard tool output envelope:
64
61
 
65
62
  - `ok`: success flag
66
63
  - `data`: tool payload on success
67
64
  - `error`: structured error payload on failure
68
- - `next_actions`: suggested follow-up calls/resources for the agent
69
- - `meta`: contract version, generation time, and tool id
70
65
 
71
66
  Reference resources:
72
67