/ 目錄 / 演練場 / hyper-mcp
● 社群 hyper-mcp-rs ⚡ 即開即用

hyper-mcp

作者 hyper-mcp-rs · hyper-mcp-rs/hyper-mcp

一個基於 Rust 的 MCP 伺服器,其工具都是 WebAssembly 外掛——沙箱執行、通過 OCI 簽署、在執行時動態載入。

hyper-mcp 是一個快速、記憶體安全的 MCP 伺服器,每個工具都是從 OCI 登錄表中提取的 WASM 外掛。外掛在沙箱中執行,具有明確的主機函式授權,簽名透過 sigstore 驗證。最適合想要將工具部署到代理而不信任隨機 npm 套件的團隊。

為什麼要用

核心特性

即時演示

實際使用效果

hyper.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "hyper": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "hyper": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "hyper": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "hyper": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "hyper",
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "hyper": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add hyper -- TODO 'See README: https://github.com/hyper-mcp-rs/hyper-mcp'

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: hyper-mcp

如何使用 hyper-mcp 安全地部署內部 MCP 工具

👤 正在構建內部代理工具的平台團隊 ⏱ ~45 min advanced

何時使用: 你需要為工程師提供策劃好的工具組,無法信任他們審查每個 npm MCP 套件。

前置條件
  • 已安裝 hyper-mcp 二進位檔 — 從 github.com/hyper-mcp-rs/hyper-mcp/releases 下載版本
  • 用於託管外掛的 OCI 登錄表 — GHCR 或私人的 Harbor/ECR
步驟
  1. 發佈已簽署的外掛
    我已在 ./my-plugin.wasm 構建了 WASM 外掛。將其推送到 ghcr.io/acme/my-plugin:v1 並用 sigstore 簽署。✓ 已複製
    → 外掛在登錄表上可用且有簽名
  2. 設定 hyper-mcp 以拉取並驗證它
    編輯 ~/.config/hyper-mcp/config.json 以添加外掛 URL 和必需的簽署者身份。✓ 已複製
    → 重啟後外掛出現在 hyper_mcp-list_plugins
  3. 從 Claude 呼叫工具
    使用 my-plugin 暴露的工具來執行 <X>。✓ 已複製
    → 工具在沙箱中執行;試圖超過授予能力的嘗試被拒絕

結果: 一個受限的內部工具帶,其中每個外掛都是已簽署、已版本化和沙箱化的。

注意事項
  • 預設為所有外掛授予網路存取權 — 設定每個外掛的 allowed_hosts;預設拒絕
  • 外掛由錯誤的身份簽署 — hyper-mcp 會拒絕——檢查 sigstore/rekor 日誌以查找簽署者不匹配

使用 hyper-mcp 熱交換代理工具而無需重啟用戶端

👤 迭代工具 API 的代理開發人員 ⏱ ~10 min intermediate

何時使用: 你正在測試工具,想要迭代而無需每 30 秒終止一次 MCP 工作階段。

步驟
  1. 載入新版本
    使用 my-plugin:v2 的 URL 呼叫 hyper_mcp-load_plugin。確認它已載入。✓ 已複製
    → 外掛 v2 出現在 list_plugins 中
  2. 如需要,卸載舊版本
    在 my-plugin:v1 上呼叫 hyper_mcp-unload_plugin。✓ 已複製
    → 只有 v2 保留

結果: 外掛開發的緊密內循環。

組合

與其他 MCP 搭配,撬動十倍槓桿

hyper + claude-code

在 Claude Code 內運行 hyper-mcp 作為唯一的 MCP 主機,並透過它路由所有自訂工具

用指向我的內部外掛登錄表的 hyper-mcp 替換我的 5 個基於 npx 的 MCP。✓ 已複製
hyper + mcptools

在 Claude 看到之前偵錯外掛工具介面

使用 mcp 工具列舉 hyper-mcp 目前廣告的內容。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
hyper_mcp-list_plugins 檢查已載入的內容;偵錯遺漏的工具 0
hyper_mcp-load_plugin url: str (oci://...), name?: str 在執行時添加外掛 one OCI pull
hyper_mcp-unload_plugin name: str 移除外掛——釋放記憶體並撤銷其工具 0

成本與限制

運行它的成本

API 配額
無——本地主機
每次呼叫 Token 數
取決於外掛——通常為 100–1000
費用
免費;如為私人的,OCI 登錄表託管可能需要費用
提示
在用戶端之間共享單個 hyper-mcp 主機,而不是運行許多基於 npm 的 MCP

安全

權限、密鑰、影響範圍

憑證儲存: 外掛密鑰通過配置注入;OCI 登錄表認證通過標準 docker/ghcr 登入
資料出站: 僅限於每個外掛的 allowed_hosts 中列出的主機
切勿授予: 無限制檔案系統 無限制網路

故障排查

常見錯誤與修復

外掛簽名驗證失敗

檢查 sigstore 簽署者身份是否與配置相匹配。使用正確的身份用 cosign sign 重新簽署

驗證: cosign verify <oci-url>
外掛載入但工具對 Claude 不可見

Claude 在工作階段開始時快取工具清單——載入後重啟 MCP 用戶端

驗證: hyper_mcp-list_plugins shows the plugin and its advertised tools
WASM 執行陷阱/異常

外掛超過了資源限制或遇到了不安全的操作。檢查日誌;僅當信任時才提高配置中的限制

替代方案

hyper-mcp 對比其他方案

替代方案何時用它替代權衡
Arcade你想要 Python 框架而不是 WASM 外掛隔離較少;Python 執行時而不是沙箱化的 WASM
GolfPython 優先,工具檔案的自動探索非外掛隔離;所有工具在一個流程中執行
FastMCP簡單的 Python MCP,無登錄表/沙箱需求無分發故事;每次更改都需要重新部署整個伺服器

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills