deploy_heim_application

Deploy backend applications to a local Heim runtime using the 'heim deploy' command, making them available at http://127.0.0.1:3000 with paths defined in OpenAPI specifications.

Instructions

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

Input Schema

TableJSON Schema

Name	Required	Description	Default
`path`	No	Absolute windows path to the application folder root

Implementation Reference

src/tools.ts:117-137 (handler)

The handler function executes the 'heim deploy' command using child_process.exec.promisify on the provided application path, returning stdout/stderr or an error.

async (request) => {
  const execPromise = util.promisify(exec);
  try {
    const { stdout, stderr } = await execPromise(
      `heim deploy ${request.path}`
    );
    return {
      content: [
        {
          type: "text",
          text: `stdout:\n${stdout}\nstderr:\n${stderr}`,
        },
      ],
    };
  } catch (err: any) {
    return {
      content: [{ type: "text", text: `Error: ${err.message}` }],
      isError: true,
    };
  }
}

src/tools.ts:104-109 (schema)
Input schema defining an optional 'path' string parameter for the absolute path to the application folder.
```
inputSchema: {
  path: z
    .string()
    .describe("Absolute windows path to the application folder root")
    .optional(),
},
```

src/tools.ts:98-137 (registration)

Registers the 'deploy_heim_application' tool with the MCP server, including title, description, input schema, annotations, and handler function.

server.registerTool(
  "deploy_heim_application",
  {
    title: "Deploy Heim Application",
    description:
      "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<PATH> where <PATH> is the path defined in your OpenAPI specification",
    inputSchema: {
      path: z
        .string()
        .describe("Absolute windows path to the application folder root")
        .optional(),
    },
    annotations: {
      destructiveHint: false,
      readOnlyHint: false,
      idempotentHint: true,
      openWorldHint: false,
    },
  },
  async (request) => {
    const execPromise = util.promisify(exec);
    try {
      const { stdout, stderr } = await execPromise(
        `heim deploy ${request.path}`
      );
      return {
        content: [
          {
            type: "text",
            text: `stdout:\n${stdout}\nstderr:\n${stderr}`,
          },
        ],
      };
    } catch (err: any) {
      return {
        content: [{ type: "text", text: `Error: ${err.message}` }],
        isError: true,
      };
    }
  }

Heim MCP