Catalyst MCP
The Catalyst framework MCP server: the agent gets project knowledge, explains errors, checks config and follows a conversion plan
- 93 ★ on the repository
- Last commit
Extended access
Why this level
- The server reads project files and a GitHub token enables creating issues and pull requests in your name
- The task plan is saved in a local project database
Install
- Works in
Manual install
npx create-catalyst-app@latestAnswer Y to the MCP support question; connect `mcp.js` to the client by absolute path.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The server reads project files and a GitHub token enables creating issues and pull requests in your name
- The task plan is saved in a local project database
This is third-party code. Review the repository files before installing.
What it does
Catalyst is a React framework with server rendering for web apps and universal apps for Android and iOS. It comes with an MCP server that `create-catalyst-app` adds to a project as an `mcp.js` file. The server reads the installed `catalyst-core` version and answers for it: webpack instructions for the 0.2.x branch and Vite with the integrated router for 0.3.x. Tools analyze the project: `debug_issue` and `explain_error` by error code such as `PREFLIGHT-001`, `check_config` checks platform configuration, `get_build_flow` and `get_architecture_diagram` show the build and structure. App conversion uses `get_conversion_tasks`, `get_conversion_status` and a step plan (`create_task_plan`, `update_task_step`) stored in a database that survives context resets. `query_knowledge` searches the knowledge base, and `create_github_issue` and `create_github_pr` file requests.
Who it is for. Teams on the Catalyst framework who need an agent that knows the project version, its configuration and how to convert a web app into a universal one.
Good fit when
- A build fails with code `PREFLIGHT-001` and the cause must be found
- A Catalyst web app is being converted to universal and the agent needs a step plan with saved state
- A project is on version 0.2.x while some examples belong to 0.3.x
- The Android and iOS config must be checked before a build
Not a fit when
- The project is not on Catalyst: the server only knows this framework
- Tools in a running app for in-browser agents are needed: that is the separate WebMCP and not this server
- One shared server for several projects is needed: setup is done separately in each project
Example request
Explain error PREFLIGHT-001 in my Catalyst project and show how the Android build works in debug modeMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
GITHUB_TOKENsecret- GitHub token for the issue and pull request tools.
Limitations
The server is created by `npx create-catalyst-app@latest` and connected through the project `mcp.js` file by absolute path. In a monorepo setup runs from the app package and not from the root. Node.js 20 or newer is required and the task plan is stored in a local SQLite database. If the installed `catalyst-core` version cannot be determined, confirm the version by hand before migration steps. `create_github_issue` and `create_github_pr` need a GitHub token taken from `GITHUB_TOKEN`, `GITHUB_PAT`, `CATALYST_GITHUB_TOKEN` or a `gh` session. The 0.2.x and 0.3.x branches differ in build.
How to disable. Remove the `catalyst` entry from `claude_desktop_config.json` or `.cursor/mcp.json` and optionally delete the project `mcp.js` file.
FAQ
How do I enable MCP in a Catalyst project?
When creating a project with `npx create-catalyst-app@latest` answer Y to the MCP support question and an `mcp.js` appears in the project.
How do I connect it to Claude Desktop?
Add `catalyst` to `claude_desktop_config.json` with the `node` command and the absolute path to your project `mcp/mcp.js`.
How does MCP differ from WebMCP?
This server runs at development time in Node and helps AI tools understand the project. WebMCP exposes tools of the running app to in-browser agents.
Which framework versions are supported?
The server reads the installed version and separates instructions for 0.2.x on webpack from 0.3.x on Vite with the integrated router.
What license applies?
MIT.
Discussion
No questions or reviews yet.
Related
MCP serversThe CodeRocket MCP server gives an agent a saved library's design rules, components and blocks over a read-only connection.
An agent gets the MDMA spec, prompts and validation so it can answer with forms, tables and approvals right inside Markdown
ReactUse MCP: React hooks reference
ReactUse MCP
ReactUse MCP server: the agent finds the right React hook and reads its description, example and API table straight from the library
Vibe MCP gives an agent components, icons and tokens of the monday.com Vibe design system
UI5 MCP Server helps an agent scaffold SAP UI5 apps, validate the manifest and code with a linter and read the current API.
Ignite UI CLI scaffolds Angular, React and Web Components projects, and ig ai-config sets up MCP servers and skills.
README in short
The framework README describes Catalyst, a quick start with `create-catalyst-app` and documentation links. The MCP docs page explains enabling, connecting to Claude Desktop, Cursor and Deputy Dev and monorepo rules.