Skip to content
MCP server

loenn-mcp

Read, edit, validate, preview and generate Celeste .bin maps from an AI client

Runs locallyStatus and history
Install
Platforms
CLI, Windows
Runs
Locally
Version
7.2.0
Listing updated
today

Similar MCP servers

About loenn-mcp

loenn-mcp is an MCP server for games and play. It runs locally on your machine and is started by your AI client.

Loenn-mcp is aimed at Celeste mod makers who want an agent to work on map files without opening the Lönn editor. It handles Everest mods and maps made in Lönn or Ahorn. The README stresses that despite the name no AI runs inside: every tool is deterministic and procedural, and the agent is simply whoever calls it.

Tools cover reading rooms and tiles, searching entities and triggers, adding and moving entities, creating rooms and maps, decals and stylegrounds, entity definitions taken from Lönn plugins, playability validation with auto-fix, ASCII and interactive HTML previews, and JSON round-tripping of whole maps. It can also drive a running game through Everest's debug server and play CelesteTAS inputs to test a room.

Writes are guarded. Each write keeps a timestamped backup, maps open in Lönn are protected, and protected chapter maps change only through copy, diff and commit steps. A companion pcgscene CLI supports scripting and CI, and generators build rooms from patterns, images or seeded noise.

Install

Run in a terminal

claude mcp add loenn-mcp -- npx -y https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "loenn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "loenn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "loenn-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "loenn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "loenn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • LOENN_MCP_WORKSPACERoot of the Celeste mod project; map paths are relative to it (default: current directory)

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

list_maps
List .bin map files
read_map_overview
Summarise rooms, entities, triggers and stylegrounds
read_room
Full room details
search_entities
Find entities by type, position or room
add_entity
Place an entity
set_room_tiles
Replace a tile grid
create_map
Create a new .bin file
map_to_json
Convert a map to typed JSON
validate_map
Check playability
render_map_html
Interactive HTML map preview
generate_map_from_image
Convert an image to a map
generate_terrain_map
Procedural terrain map
game_play_tas
Play CelesteTAS inputs in the game
map_commit
Commit a copy to a protected map

What it does

Map reading and search
Inspect rooms, tiles, entities and triggers across .bin maps.
Safe editing
Timestamped backups, atomic writes and protected maps.
Playability validation
Validate maps and auto-fix some problems.
Procedural generation
Generate rooms from patterns, images or seeded terrain.
Interactive preview
Render maps to a zoomable HTML view.
Game control
Reload maps, teleport and play TAS inputs in the running game.

Good for

  • Add entities to a Celeste room from a prompt
  • Validate a map before release
  • Generate a gray-box layout from an image
  • Preview a planned merge before writing it
  • Audit missing Lönn plugin definitions

loenn-mcp FAQ

Does it use AI internally?

No. The README says every tool is deterministic and procedural.

Does it overwrite my maps?

Every write keeps a timestamped backup, and protected maps change only through a commit step.

Is there a command-line tool?

Yes, pcgscene for scripting and CI.

How is it installed?

The registry lists a packaged bundle release; the README also mentions a PyPI package.

How do I add loenn-mcp to Claude Code?

Run this command in your terminal: claude mcp add loenn-mcp -- npx -y https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb

What are the best alternatives to loenn-mcp?

The closest alternatives to loenn-mcp are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers