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 許可證。