loenn-mcp
Read, edit, validate, preview and generate Celeste .bin maps from an AI client
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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.


