hyper-mcp

hyper-mcp

site icon
2025.04.18 399
RustAI 能力扩展WebAssembly 插件跨平台部署开发效率
hyper-mcp 是一个快速、安全的 MCP 服务器,通过 WebAssembly 插件扩展其功能。它使得为应用程序添加 AI 能力变得简单,支持与 Claude Desktop、Cursor IDE 等 MCP 兼容的应用程序。用户可以使用任何能编译成 WebAssembly 的语言编写插件,并通过标准的 OCI 注册表(如 Docker Hub)分发插件。hyper-mcp 基于 Extism 构建,提供轻量级、跨平台的插件支持,适用于从云到边缘的各种部署场景。
View on GitHub

Overview

基本能力

产品定位

hyper-mcp 是一个快速、安全的 MCP 服务器,通过 WebAssembly 插件扩展其功能,使得为应用程序添加 AI 能力变得简单。

核心功能

  • 支持使用任何能编译成 WebAssembly 的语言编写插件
  • 通过标准的 OCI 注册表(如 Docker Hub)分发插件
  • 基于 Extism 构建,提供稳定的插件支持
  • 轻量级,适用于资源受限的环境
  • 跨平台兼容性
  • 安全第一的设计理念,包括沙盒化插件、内存安全执行、细粒度的主机功能访问控制等

适用场景

  • 为应用程序添加 AI 能力
  • 在云、边缘、移动设备和 IoT 设备上部署插件
  • 开发跨平台的插件解决方案

工具列表

hyper-mcp 提供了一系列示例插件,包括: - time:获取当前时间并进行时间计算 - qr-code:生成 QR 码 - hash:生成各种类型的哈希 - myip:获取当前 IP - fetch:基本的网页抓取 - crypto-price:获取加密货币价格 - fs:文件系统操作 - github:GitHub 插件 - eval-py:使用 RustPython 评估 Python 代码 - arxiv:搜索和下载 arXiv 论文

常见问题解答

  • 如何加载未签名的 OCI 插件?:使用 --insecure-skip-signature 标志。
  • 日志存储在哪里?:默认情况下,日志存储在平台特定的目录中(如 Linux 的 $XDG_DATA_HOME$HOME/.local/share)。

使用教程

使用依赖

hyper-mcp 需要 Rust 环境来构建和运行。确保已安装 Rust 和 Cargo。

安装教程

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

配置文件示例: json { "plugins": [ { "name": "time", "path": "oci://ghcr.io/tuananh/time-plugin:latest" }, { "name": "qr-code", "path": "oci://ghcr.io/tuananh/qrcode-plugin:latest" } ] }

  1. 启动服务器: sh $ hyper-mcp

调试方式

  • 检查日志文件以获取运行时的详细信息。
  • 使用 --insecure-skip-signature 标志来加载未签名的插件。

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。