Heim MCP

🚀 Heim MCP

Heim MCP 是用于 Heim 应用程序部署和管理的 模型上下文协议（Model Context Protocol） 服务器。它允许 Claude Desktop、Cursor、Windsurf 等 AI 代理通过自然语言命令直接创建、部署和管理 Heim 应用程序。

🚀 快速开始

在使用此 MCP 服务器之前，你需要在系统上安装 Heim。你可以按照 https://heim.dev/releases/ 上的说明进行安装。

✨ 主要特性

• 允许 AI 代理（如 Claude Desktop、Cursor、Windsurf 等）通过自然语言命令直接创建、部署和管理 Heim 应用程序。
• 可直接要求 AI 根据 OpenAPI 规范创建新的 Heim 应用程序，将其部署到本地或云端，并管理 Heim 运行时。

📦 安装指南

全局安装

使用 npx 运行 MCP 服务器：

npx -y @nor2/heim-mcp@latest

在你的 Cursor IDE 中：

1. 转到 Cursor 设置 > MCP。
2. 点击 + 添加新的 MCP 服务器。
3. 填写表单：
   • 名称：Heim（或你喜欢的任何名称）
   • 类型：命令
   • 命令：npx -y @nor2/heim-mcp@latest

项目特定安装

在你的项目中添加一个 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "heim": {
      "command": "npx",
      "args": [
        "-y",
        "@nor2/heim-mcp@latest"
      ]
    }
  }
}

Roo Code 安装

在 Roo Code 设置中点击“编辑 MCP 设置”或使用 VS Code 命令面板中的“Roo Code: 打开 MCP 配置”命令来访问 MCP 设置。

{
  "mcpServers": {
    "heim": {
      "command": "npx",
      "args": [
        "-y",
        "@nor2/heim-mcp@latest"
      ]
    }
  }
}

💻 使用示例

基础用法

配置完成后，Heim 工具将自动可供 Cursor AI 代理使用。你可以：

1. 要求 AI 根据 OpenAPI 规范创建新的应用程序。
2. 将应用程序部署到本地或云端。
3. 管理 Heim 运行时。
4. 这些工具将列在 MCP 设置的 可用工具 下。

📚 详细文档

可用工具

🔧 技术细节

开发

# 安装依赖
pnpm install

# 构建
pnpm build

服务器调试

要调试你的服务器，你可以使用 MCP 检查器。 首先构建服务器：

pnpm build

在你的终端中运行以下命令：

# 启动 MCP 检查器和包含所有工具的服务器
npx @modelcontextprotocol/inspector node dist/index.js

📄 许可证

本项目采用 MIT 许可证。