Heim MCP
Enables installation and execution of the MCP server through npx, allowing users to run the Heim MCP server without installing it permanently.
Supports development workflows for the MCP server itself, including installing dependencies and building the server.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Heim MCP create a new application from this OpenAPI spec"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Heim MCP
Model Context Protocol server for Heim application deployment and management.
Overview
This MCP server allows AI agents like Claude Desktop, Cursor, Windsurf, and others to create, deploy, and manage Heim applications directly through natural language commands.
Purpose You can directly ask the AI to create new Heim applications from OpenAPI specifications, deploy them locally or to the cloud, and manage the Heim runtime.
What is Heim? Heim is a platform for creating and deploying backend applications.
Related MCP server: Hello World MCP Server
Available Tools
Tool | Description |
| Creates a new Heim application from an OpenAPI 3.0.1 specification |
| Deploys an application to the local Heim runtime (available at http://127.0.0.1:3000) |
| Deploys an application to Heim cloud |
| Starts the Heim runtime to handle deployment requests |
| Clears the local cache and stops the Heim runtime |
| Updates Heim to the latest version |
Using with Cursor
Installation - Globally
Run the MCP server using npx:
npx -y @nor2/heim-mcp@latestIn your Cursor IDE
Go to
Cursor Settings>MCPClick
+ Add New MCP ServerFill in the form:
Name:
Heim(or any name you prefer)Type:
commandCommand:
npx -y @nor2/heim-mcp@latest
Installation - Project-specific
Add an .cursor/mcp.json file to your project:
{
"mcpServers": {
"heim": {
"command": "npx",
"args": [
"-y",
"@nor2/heim-mcp@latest"
]
}
}
}Usage
Once configured, the Heim tools will be automatically available to the Cursor AI Agent. You can:
Ask the AI to create new applications from OpenAPI specs
Deploy applications locally or to the cloud
Manage the Heim runtime
The tools will be listed under
Available Toolsin MCP settings
Using with Roo Code
Access the MCP settings by clicking "Edit MCP Settings" in Roo Code settings or using the "Roo Code: Open MCP Config" command in VS Code's command palette.
{
"mcpServers": {
"heim": {
"command": "npx",
"args": [
"-y",
"@nor2/heim-mcp@latest"
]
}
}
}Prerequisites
Before using this MCP server, you need to have Heim installed on your system. You can install it by following the instructions at https://heim.dev/releases/.
Development
# Install dependencies
pnpm install
# Build
pnpm buildDebugging the Server
To debug your server, you can use the MCP Inspector.
First build the server:
pnpm buildRun the following command in your terminal:
# Start MCP Inspector and server with all tools
npx @modelcontextprotocol/inspector node dist/index.jsLicense
Available Tools
6 toolsdeploy_heim_applicationDeploy Heim ApplicationAIdempotent
Runs 'heim deploy' command to deploy an application to a local Heim runtime. Which will make the application availible on http://127.0.0.1:3000 where is the path defined in your OpenAPI specification
Inputs: path.
deploy_heim_application_to_cloudDeploy Heim Application to CloudBIdempotent
Runs 'heim deploy' command to deploy an application to Heim cloud. Which will make the application availible on the path outputted in the console
Inputs: path.
heim_clearADestructive
Clears the local cache of the Heim runtime which will attempt to stop the runtime and remove all applications, logs, metrics, etc. from the runtime.
Inputs: no named parameters.
heim_startB
Starts the Heim runtime which will run your backend applications.
Inputs: no named parameters.
heim_updateB
Updates Heim to the latest version.
Inputs: no named parameters.
new_heim_applicationNew Heim ApplicationA
Runs 'heim new' command on your local computer to create application schafholding from an OpenAPI 3.0.1 specification.
Inputs: path (required), openApiPath (required), name (required), language (required), +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose with no ambiguity. The tools cover deployment (local and cloud), runtime management (start, clear), system update, and application creation, with no overlap in functionality. An agent can easily distinguish between them based on their specific actions.
The naming is mostly consistent with a verb_noun pattern, using underscores throughout. However, there is a minor deviation: 'new_heim_application' uses 'new' as a verb, while others like 'deploy_heim_application' use more standard action verbs, but this does not significantly hinder readability or predictability.
With 6 tools, the count is well-scoped for managing a Heim application lifecycle. Each tool earns its place by covering key operations such as deployment, runtime control, updates, and application creation, without being overly sparse or bloated.
The tool set provides good coverage for the Heim domain, including deployment (local and cloud), runtime management, updates, and application creation. A minor gap exists in monitoring or logging tools, but core workflows are well-supported, allowing agents to perform essential tasks without significant dead ends.
Maintenance
Related MCP Connectors
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
The official MCP Server from Mia-Platform to interact with Mia-Platform Console
Create, deploy, and operate MCP servers directly from your GitHub repositories.
A MCP server built for developers enabling Git based project management with project and personal…
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server for managing your repositories on Forgejo/Gitea server.70Mozilla Public 2.0
- -licenseCqualityNot gradedmaintenanceA simple boilerplate MCP server that provides a basic greeting tool for demonstration purposes. Serves as a starting template for developers to quickly create and deploy custom MCP servers.110 npm-
- AlicenseNot gradedqualityDmaintenanceProduction-ready MCP server starter with authentication, observability, and a plugin system for building and deploying MCP servers quickly.MIT
- AlicenseBqualityDmaintenanceDynamic MCP server for Node.js enabling runtime tool creation, management, and execution in isolated sandboxes (Docker or Node).811 npm1MIT