erdalgunes/mira-mcp

Mira MCP Server

Advanced MCP (Model Context Protocol) server for controlling Onyx Boox Mira e-ink displays directly from Claude.

Features

• Intelligent Presets: Optimized settings for coding, terminal, reading, scrolling, and presentations
• Auto-Detection: Automatically applies the best preset based on your active application
• Fine Control: Adjust individual parameters like contrast, speed, refresh mode
• Smart Refresh: Clear ghosting on demand
• Backlight Control: Adjust warm/cold light for eye comfort

Installation

1. Install dependencies:

cd /Users/erdalgunes/Research/mira-mcp
npm install

2. Build the TypeScript code:

npm run build

3. Add to Claude's MCP configuration:

# Edit Claude's config
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add this to the mcpServers section:

{
  "mcpServers": {
    "mira-mcp": {
      "command": "node",
      "args": ["/Users/erdalgunes/Research/mira-mcp/build/index.js"]
    }
  }
}

4. Restart Claude Desktop

Usage in Claude

Once installed, you can use these commands:

Quick Presets

• "Apply coding preset" - Optimized for IDEs
• "Apply terminal preset" - Best for command line
• "Apply reading preset" - Comfortable for long reading
• "Apply scrolling preset" - Fast refresh for web browsing
• "Apply presentation preset" - High contrast for slides

Auto-Detection

• "Auto detect and apply preset" - Detects your active app and applies the best preset

Manual Control

• "Set contrast to 12" - Adjust contrast (0-15)
• "Set speed to 5" - Adjust refresh speed (1-7)
• "Set refresh mode to gray" - Choose mode (a2/direct/gray)
• "Refresh display" - Clear any ghosting
• "Enable anti-shake" - Reduce ghosting

Backlight

• "Set warm light to 80 and cold light to 50" - Adjust backlight

Information

• "List all presets" - See all available presets
• "Get current settings" - View active configuration

Presets Explained

Coding (VSCode, Android Studio)

• Gray mode for clear text
• Medium speed (5/7)
• High contrast (11/15)
• Warm-biased backlight

Terminal

• Gray mode with faster refresh
• Higher speed (6/7)
• Maximum contrast (12/15)
• Balanced backlight

Reading

• Gray mode with high dithering
• Slower speed for stability
• Moderate contrast
• Very warm light

Scrolling (Web Browsing)

• A2 mode for fast updates
• Maximum speed
• No dithering for speed
• Balanced backlight

Presentation

• Direct mode for clarity
• Maximum contrast
• Bright backlight
• No dithering

Troubleshooting

If the MCP server can't connect to the Mira:

1. Ensure Mira is connected via USB/Thunderbolt
2. You may need to run Claude with elevated permissions
3. Check that the Mira app isn't already controlling the device

Development

To modify the server:

# Development mode with auto-reload
npm run dev

# Build for production
npm run build

Advanced Features

The MCP server includes:

• Active application detection
• Automatic preset switching
• Settings persistence
• Error recovery
• Connection monitoring

Power User Tips

1. Create keyboard shortcuts in your OS to trigger Claude commands
2. Use "auto detect" when switching between apps
3. Refresh display periodically to prevent ghosting
4. Adjust warm/cold light based on time of day
5. Use A2 mode temporarily for fast scrolling, then switch back to gray

License

MIT