Heim MCP

🚀 Heim MCP

The Model Context Protocol server for Heim application deployment and management. It enables AI agents to interact with Heim applications using natural - language commands.

🚀 Quick Start

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/.

✨ Features

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.

📦 Installation

Installation - Globally

Run the MCP server using npx:

npx -y @nor2/heim-mcp@latest

In your Cursor IDE:

1. Go to Cursor Settings > MCP.
2. Click + Add New MCP Server.
3. Fill in the form:
   • Name: Heim (or any name you prefer).
   • Type: command.
   • Command: 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 Examples

Using with Cursor

Once configured, the Heim tools will be automatically available to the Cursor AI Agent. You can:

1. Ask the AI to create new applications from OpenAPI specs.
2. Deploy applications locally or to the cloud.
3. Manage the Heim runtime.
4. The tools will be listed under Available Tools in 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"
      ]
    }
  }
}

📚 Documentation

Available Tools

🔧 Technical Details

Development

# Install dependencies
pnpm install

# Build
pnpm build

Debugging the Server

To debug your server, you can use the MCP Inspector. First build the server:

pnpm build

Run the following command in your terminal:

# Start MCP Inspector and server with all tools
npx @modelcontextprotocol/inspector node dist/index.js

📄 License

MIT