oscar64-mcp-docs

MCP server for Oscar64 docs and source examples over stdio.

What this server gives your agent

• Search across manual pages, headers, tutorials, and sample code.
• Read any returned docs://... or code://... URI directly.
• Discover index entries (headers, tutorials, samples, topics) for navigation.

Core tools:

• search
• read_uri
• list_indexes

Requirements

• Node.js >=22.13.0

Install and run command

Use this command as your MCP server command in clients:

npx -y oscar64-mcp-docs

Optional cache location:

OSCAR_MCP_CACHE_DIR=/path/to/cache npx -y oscar64-mcp-docs

Default cache path is ~/.cache/oscar-mcp.

MCP client setup (generic)

Most coding agents and MCP clients use the same server config shape:

{
  "mcpServers": {
    "oscar64": {
      "command": "npx",
      "args": ["-y", "oscar64-mcp-docs"],
      "env": {
        "OSCAR_MCP_CACHE_DIR": "/absolute/path/optional"
      }
    }
  }
}

If your client uses different field names, map the same values (command, args, optional env) into its equivalent MCP fields.

If your client has a CLI helper for MCP registration, the command it runs should still be:

npx -y oscar64-mcp-docs

How to use from an agent

Recommended flow:

1. Call search with the API/symbol/topic you need.
2. Take the returned uri (docs://... or code://...).
3. Call read_uri on that URI for exact content.
4. Use list_indexes when you want broad discovery before searching.

URI types

• docs://... for manual/docs pages
• code://oscar/...
• code://sample/...
• code://tutorial/...

Local development

npm install
npm run check
npm run test
npm run dev

Build executable:

npm run build

Output entrypoint: dist/stdio.js