Oscar64 Docs MCP

Access the complete Oscar64 C compiler documentation through conversation - AI-powered search across manual pages, headers, tutorials, and sample code.

Features

• 🔍 Smart Search: Find functions, symbols, topics across all documentation
• 📚 Documentation Access: Read manual pages and API references
• 💡 Tutorial Browsing: Explore Oscar64 tutorials and guides
• 📝 Code Examples: Search and read sample C64 programs
• 🗂️ Index Discovery: Navigate headers, tutorials, samples, and topics

Requirements

• Node.js >= 22.13.0
• MCP-compatible AI assistant (Claude Code, Codex, Windsurf, etc.)

Installation

claude mcp add oscar64-docs -- npx -y oscar64-docs-mcp@latest

Or add manually to your MCP client config:

{
  "mcpServers": {
    "oscar64-docs": {
      "command": "npx",
      "args": ["-y", "oscar64-docs-mcp@latest"]
    }
  }
}

The server caches Oscar64 documentation at ~/.cache/oscar-mcp. To use a different location, set the OSCAR_MCP_CACHE_DIR environment variable in your MCP client configuration.

Quick Start

1. Add MCP server (see Installation above)

2. Ask your AI assistant about Oscar64:

   • "How do I use sprites in Oscar64?"
   • "Show me examples of reading joystick input"
   • "What functions are available for SID music?"

Example Workflows

Finding API Functions

You: What functions are available for VIC-II graphics?

AI assistant will:
1. Search for VIC-II related functions
2. Read and explain the relevant API docs
3. Show you how to use them in your code

Exploring Tutorials

You: Show me Oscar64 tutorials about raster effects

AI assistant will:
1. List available tutorials
2. Search for raster-related content
3. Read and present the tutorial content

Code Examples

You: Find sample code for scrolling

AI assistant will:
1. Search sample code for scrolling examples
2. Read and display the source code
3. Explain how the code works

License

MIT - see LICENSE file

Made with ❤️ for C64 developers and AI-assisted retro coding

"The C64 never gets old, it just gets smarter" 🎮