MCPgee
MCPgee
MCPgeeMCPgee

Gearlynx

v1.0.0•Developer Tools•stable

Atari Lynx emulator, debugger, and embedded MCP server for macOS, Windows, Linux, BSD and RetroArch.

ataribsdemulatorlibretrolinux
Share:
66
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Gearlynx?

Gearlynx is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to atari lynx emulator, debugger, and embedded mcp server for macos, windows, linux, bsd and retroarch.

Atari Lynx emulator, debugger, and embedded MCP server for macOS, Windows, Linux, BSD and RetroArch.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Atari Lynx emulator, debugger, and embedded MCP server for m

Use Cases

Emulate Atari Lynx games through MCP.
Debug Atari Lynx ROMs with embedded debugging.
Run classic games across macOS, Windows, Linux, BSD.
drhelius

Maintainer

LicenseGPL-3.0
Languagec++
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx gearlynx

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Gearlynx

Gearlynx is a full-featured Atari Lynx emulator and debugger for macOS, Windows, Linux, BSD, and RetroArch that includes an embedded MCP server for AI-assisted reverse engineering and debugging. The MCP interface exposes emulation controls, memory inspection, breakpoints, disassembly, and hardware status to AI agents like Claude, GitHub Copilot, and Codex. Developers and retro-game enthusiasts use it to analyze Lynx ROMs, set breakpoints, inspect hardware registers, and automate debugging workflows entirely through natural language.

Prerequisites

  • An Atari Lynx BIOS file (recommended MD5: fcd403db69f54290b51035d82f835e7b)
  • macOS, Windows, Linux, or BSD operating system with appropriate dependencies (libsdl3 on Linux)
  • An MCP-compatible client such as Claude Desktop or GitHub Copilot
  • For Linux builds: build-essential and libsdl3-dev packages (or SDL3 built from source on older distros)
1

Install Gearlynx

Download the appropriate binary for your platform from the GitHub releases page. On macOS you can use Homebrew for convenience.

brew install --cask drhelius/geardome/gearlynx
2

Provide the BIOS file

Place the Atari Lynx BIOS file (lynxboot.img) in the directory Gearlynx expects. The application will prompt you to locate it on first launch if it is not found automatically.

3

Start Gearlynx with MCP server enabled

Launch Gearlynx with the --mcp-http flag to start the embedded MCP HTTP server on the default port 7777. Use --headless if you do not need the GUI.

gearlynx --mcp-http --mcp-http-port 7777 --headless
4

Configure your MCP client to connect

Add Gearlynx as an MCP server in your client configuration, connecting to the HTTP transport it exposes.

{
  "mcpServers": {
    "gearlynx": {
      "type": "http",
      "url": "http://127.0.0.1:7777"
    }
  }
}
5

Load a ROM and start debugging

Open a Lynx ROM through the Gearlynx UI or via command line. Once the emulator is running, your AI assistant can inspect memory, set breakpoints, and control execution through MCP tools.

6

Install optional AI skill packages

Install pre-built skill packages to give your AI agent specialized knowledge for Lynx debugging or ROM hacking tasks.

npx skills add drhelius/gearlynx

Gearlynx Examples

Client configuration

Connect Claude Desktop to a running Gearlynx HTTP MCP server. Set GEARLYNX_MCP_HTTP_TOKEN if you configured bearer token authentication.

{
  "mcpServers": {
    "gearlynx": {
      "type": "http",
      "url": "http://127.0.0.1:7777",
      "headers": {
        "Authorization": "Bearer your_optional_token"
      }
    }
  }
}

Prompts to try

These prompts leverage Gearlynx's MCP tools for emulation control, memory inspection, and breakpoint management.

- "Set a breakpoint at memory address 0x4000 and tell me when it's hit."
- "Show me the current state of the Lynx hardware registers."
- "Disassemble the code starting at the current program counter."
- "Search memory for the byte sequence FF 00 FF and list all matches."
- "Step through 10 CPU instructions and report any register changes."

Troubleshooting Gearlynx

MCP server not reachable at 127.0.0.1:7777

Confirm Gearlynx started with the --mcp-http flag. Check for port conflicts with 'lsof -i :7777'. You can change the port with --mcp-http-port and update your client config to match.

BIOS file not found on startup

Gearlynx requires the Lynx BIOS (lynxboot.img). Place it in the application's data directory or use the UI to browse to it. The recommended BIOS has MD5 checksum fcd403db69f54290b51035d82f835e7b.

libsdl3 missing on Linux

Install SDL3 via your package manager: 'sudo apt install libsdl3-dev' on Ubuntu 24.04+. For older distributions, build SDL3 from source as described in the Gearlynx repository's Linux build instructions.

Frequently Asked Questions about Gearlynx

What is Gearlynx?

Gearlynx is a Model Context Protocol (MCP) server that atari lynx emulator, debugger, and embedded mcp server for macos, windows, linux, bsd and retroarch. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Gearlynx?

Follow the installation instructions on the Gearlynx GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Gearlynx?

Gearlynx works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Gearlynx free to use?

Yes, Gearlynx is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Gearlynx Alternatives — Similar Developer Tools Servers

Looking for alternatives to Gearlynx? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer ToolsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "gearlynx": { "command": "npx", "args": ["-y", "gearlynx"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Gearlynx?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides