/ 目录 / 演练场 / 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 验证签名。最适合那些想要向 agent 发布工具但不信任随机 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 工具

👤 构建内部 agent 工具的平台团队 ⏱ ~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 热交换 agent 工具而无需重启客户端

👤 在工具 API 上迭代的 agent 开发者 ⏱ ~10 min intermediate

何时使用: 你正在测试一个工具,想要快速迭代而不是每 30 秒杀死一次 MCP 会话。

步骤
  1. 加载新版本
    调用 hyper_mcp-load_plugin,传入 my-plugin:v2 的 URL。确认已加载。✓ 已复制
    → 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 tools 枚举 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 显示插件及其宣传的工具
WASM 执行陷阱/panic

插件超出资源限制或触发了不安全操作。检查日志;仅在信任时在配置中提高限制

替代方案

hyper-mcp 对比其他方案

替代方案何时用它替代权衡
Arcade你想要 Python 框架而不是 WASM 插件隔离程度较低;Python 运行时而不是沙箱 WASM
GolfPython 优先,工具文件自动发现未进行插件隔离;所有工具在一个进程中运行
FastMCP简单的 Python MCP,无需仓库/沙箱没有分发策略;每次变更都需要重新部署整个服务器

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills