celeste-cli: MCP bridge for Celeste modding and AI workflows
celeste-cli, developed by Whykusanagi, is an MCP server that connects AI assistants to the Celeste modding ecosystem for programmatic access to local game information. The app exposes a structured interface that lets language models query game data, mod metadata, and workspace assets through a command-line hosted server. It supports extension with custom tools and is aimed at Celeste modders and developers who want AI-assisted inspection, design suggestions, and automated data extraction within modding workflows.
What tasks can you actually use it for?
The tool supplies programmatic access to local Celeste resources so language models can perform targeted tooling tasks. It converts raw game data into queryable endpoints that assist with inspection, search, and analysis inside a mod workspace. Typical uses include automated asset discovery, metadata inspection for installed mods, and exposing level structure for model-driven suggestions. Developers can invoke the server from command line and script queries from an AI client to examine game elements.
Parsing .bin map files to extract entities and triggers.
Listing and inspecting installed mods and metadata via Everest.
Searching for assets and sprites in a mod workspace.
Responding to MCP queries from AI clients.
How reliable are the tool's AI-facing outputs for mod design?
Structured dumps and search results produce machine-readable outputs that an LLM can interpret for level suggestions or debugging. Outputs are factual representations of the extracted files and metadata; the tool does not apply automated game changes. As noted in its documentation, suggested level designs require manual integration or additional scripts, so AI proposals function as drafts that a modder or developer must validate and implement before they appear in-game.
What inputs and hosting constraints must you meet?
Hosting the server requires a valid Celeste installation and the Everest mod loader to supply meaningful game data. The server must run inside an MCP-compliant client such as Claude Desktop or Cursor so AI agents can connect. The developer states cross-platform compatibility with Windows, macOS, and Linux. The environment also expects an up-to-date Node.js runtime to execute the command-line server component.
Does it fit into existing modder workflows without heavy coding?
Setup and extension target technically proficient users. The server exposes a command-line interface for configuration and workspace management, and its architecture supports adding custom tools to expand queries or processing. The project is open-source and community-driven, enabling contributors to add integrations or tailor responses for specific mod workflows. Connecting the server to an AI client requires adding the server configuration and executable path to the client's settings as described in the documentation.
Suited to developers who accept manual integration and configuration
The tool is a practical choice for Celeste modders and developers who want programmatic, AI-accessible views of local game resources and who can manage MCP hosting. It requires technical setup and manual follow-through on AI proposals, so it suits users who plan to extend or script integrations themselves. Nontechnical modders may find the configuration and implementation steps a barrier to immediate, turn-key use.
Pros
MCP-compliant server enabling AI clients to query local Celeste game data
Parses binary map files into structured, model-readable outputs
Extensible CLI architecture supports custom tools and community contributions
Compatible with MCP clients like Claude Desktop and Cursor
Cons
Requires a valid Celeste installation and the Everest mod loader
Needs an MCP host client plus Node.js runtime for the server
AI-generated level suggestions require manual integration or extra scripts
Niche tool aimed at developers; not ideal for casual modders
Laws concerning the use of this software vary from country to country. We do not encourage or condone the use of this program if it is in violation of these laws. Softonic may receive a referral fee if you click or buy any of the products featured here.