Heim MCP

Instructions

Implementation Reference

• src/tools.ts:198-215 (handler)

  The handler function for the 'heim_start' tool. It promisifies the exec function, runs 'heim start', captures stdout and stderr, and returns formatted content or an error response.

    const execPromise = util.promisify(exec);
    try {
      const { stdout, stderr } = await execPromise("heim start");
      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:188-196 (schema)

  The schema/metadata for the 'heim_start' tool, including title, description, and operation hints.

  {
    title: "Start Heim Runtime",
    description:
      "Starts the Heim runtime which will run your backend applications and handle deployment requests of your applications.",
    destructiveHint: false,
    readOnlyHint: false,
    idempotentHint: false,
    openWorldHint: false,
  },

• src/tools.ts:185-216 (registration)

  The registration of the 'heim_start' tool using server.tool(), including name, short description, schema, and handler function.

  server.tool(
    "heim_start",
    "Starts the Heim runtime which will run your backend applications.",
    {
      title: "Start Heim Runtime",
      description:
        "Starts the Heim runtime which will run your backend applications and handle deployment requests of your applications.",
      destructiveHint: false,
      readOnlyHint: false,
      idempotentHint: false,
      openWorldHint: false,
    },
    async () => {
      const execPromise = util.promisify(exec);
      try {
        const { stdout, stderr } = await execPromise("heim start");
        return {
          content: [
            {
              type: "text",
              text: `stdout:\n${stdout}\nstderr:\n${stderr}`,
            },
          ],
        };
      } catch (err: any) {
        return {
          content: [{ type: "text", text: `Error: ${err.message}` }],
          isError: true,
        };
      }
    }
  );