hyper-mcp

hyper-mcp

一款快速、安全的 MCP 服务，可通过 WebAssembly 插件扩展其功能。

这是什么？

hyper-mcp 可轻松为应用添加 AI 功能。它兼容 Claude Desktop、Cursor IDE 及其他兼容 MCP 的应用。使用你喜欢的语言编写插件，通过容器注册表分发，并在任何地方运行——从云端到边缘设备。

功能

• 使用任何可编译为 WebAssembly 的语言编写插件
• 通过标准 OCI 注册表（如 Docker Hub）分发插件
• 基于 Extism 构建，提供可靠的插件支持
• 通过 WASM 沙箱隔离：可限制网络、文件系统和内存访问
• 轻量，适用于资源受限的环境
• 支持规范中的全部 3 种协议：stdio、sse 和 streamble-http。
• 随处部署：无服务器、边缘设备、移动设备、IoT 设备
• 开箱即用的跨平台兼容性
• 支持为工具名称添加前缀，避免工具名称冲突

安全性

以安全为先进行构建：

• 插件运行于沙箱中，未经许可无法访问你的系统
• 具备资源限制的内存安全执行
• 通过容器注册表安全分发插件
• 对宿主函数进行精细的访问控制
• OCI 插件镜像在发布时使用 sigstore 签名，并在加载时验证。

开始使用

1. 创建配置文件：
   • Linux：$HOME/.config/hyper-mcp/config.json
   • Windows：{FOLDERID_RoamingAppData}。例如：C:\Users\Alice\AppData\Roaming
   • macOS：$HOME/Library/Application Support/hyper-mcp/config.json

{
  "plugins": {
    "time": {
      "url": "oci://ghcr.io/tuananh/time-plugin:latest"
    },
    "qr_code": {
      "url": "oci://ghcr.io/tuananh/qrcode-plugin:latest"
    },
    "hash": {
      "url": "oci://ghcr.io/tuananh/hash-plugin:latest"
    },
    "myip": {
      "url": "oci://ghcr.io/tuananh/myip-plugin:latest",
      "runtime_config": {
        "allowed_hosts": ["1.1.1.1"]
      }
    },
    "fetch": {
      "url": "oci://ghcr.io/tuananh/fetch-plugin:latest",
      "runtime_config": {
        "allowed_hosts": ["*"],
        "memory_limit": "100 MB",
      }
    }
  }
}

📖 有关身份验证设置、运行时配置和高级功能等详细配置选项，请参阅 RUNTIME_CONFIG.md

支持的 URL 方案：

• oci:// - 用于符合 OCI 标准的注册表（如 Docker Hub、GitHub Container Registry 等）
• file:// - 用于本地文件
• http:// 或 https:// - 用于远程文件
• s3:// - 用于 Amazon S3 对象（需要在环境中配置 AWS 凭据）

2. 启动服务：

$ hyper-mcp

• 默认使用 stdio 传输方式。若要使用 SSE，请添加标志 --transport sse；若要使用可流式传输的 HTTP，请添加 --transport streamable-http。
• 若要调试，请使用 RUST_LOG=info。
• 若要加载未签名的 OCI 插件，需要将 insecure_skip_signature 标志或环境变量 HYPER_MCP_INSECURE_SKIP_SIGNATURE 设置为 true

与 Cursor IDE 搭配使用

你可以为所有项目全局配置 hyper-mcp，也可以仅为单个项目配置。

1. 若要进行项目级配置，请在项目根目录中创建 .cursor/mcp.json：

{
  "mcpServers": {
    "hyper-mcp": {
      "command": "/path/to/hyper-mcp"
    }
  }
}

2. 在 Cursor 的设置中配置 hyper-mcp：

3. 开始通过聊天使用工具：

可用插件

我们维护了多个示例插件，供你快速上手：

V1 插件

这些插件使用 v1 插件接口。虽然仍受支持，但新插件应使用 v2 接口。

• time：获取当前时间并进行时间计算（Rust）
• qr_code：生成二维码（Rust）
• hash：生成各种类型的哈希值（Rust）
• myip：获取你当前的 IP 地址（Rust）
• fetch：基本的网页抓取（Rust）
• crypto_price：获取加密货币价格（Go）
• fs：文件系统操作（Rust）
• github：GitHub 插件（Go）
• eval_py：使用 RustPython 执行 Python 代码（Rust）
• arxiv：搜索并下载 arXiv 论文（Rust）
• memory：由 SQLite 提供支持，让你存储和检索记忆（Rust）
• sqlite：与 SQLite 交互（Rust）
• crates-io：获取 crate 基本信息并检查 crate 最新版本（Rust）
• gomodule：获取 Go 模块信息和版本（Rust）
• qdrant：将记忆保存到 Qdrant 向量搜索引擎并检索记忆（Rust）
• gitlab：GitLab 插件（Rust）
• meme_generator：表情包生成器（Rust）
• context7：查找库文档（Rust）
• think：思考工具（Rust）
• maven：Maven 插件（Rust）
• serper：Serper 网页搜索插件（Rust）

V2 插件

这些插件使用 v2 插件接口。新插件应使用此接口。

• rstime：获取当前时间并进行时间计算（Rust）

社区构建的插件

• hackernews：此插件连接到 Hacker News API，获取当前热门故事，并展示其标题、得分、作者和 URL。
• release-monitor-id：此插件从 release-monitoring.org 获取项目 ID，帮助跟踪已发布软件的版本。
• yahoo-finance：此插件连接到 Yahoo Finance API，根据公司名称或股票代码提供股票价格（OHLCV）。
• rand16：此插件可生成随机的 16 字节缓冲区，并以 base64uri 格式提供，非常适合在线对称加密。

文档

• 运行时配置指南 - 配置选项的全面指南，包括：
  • 身份验证设置（Basic、Token 和 Keyring）
  • 插件运行时配置
  • 安全注意事项和最佳实践
  • macOS、Linux 和 Windows 的平台专属 Keyring 设置
  • 身份验证问题排查
• 跳过工具模式指南 - 使用正则表达式模式筛选工具的全面指南：
  • 模式语法和示例
  • 常见用例和最佳实践
  • 特定环境的筛选策略
  • 高级正则表达式技巧
  • 迁移和问题排查

创建插件

有关创建插件的全面说明，请参阅 CREATING_PLUGINS.md。

许可证

Apache 2.0

Star 历史