返回市场
超能-MCP

超能-MCP

作者:tuananh828 星标更新:2025-11-24

项目介绍

<div align="center"> <picture> <img alt="hyper-mcp logo" src="./assets/logo.png" width="50%"> </picture> </div> <div align="center">

Rust License Issues - hyper-mcp GitHub Release

<a href="https://trendshift.io/repositories/13451" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13451" alt="tuananh%2Fhyper-mcp | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

</div>

hyper-mcp

一个快速、安全的MCP服务器,通过WebAssembly插件扩展其功能。

它是什么?

hyper-mcp使得在应用程序中添加AI能力变得容易。它与Claude Desktop、Cursor IDE和其他兼容MCP的应用程序一起工作。使用您喜欢的语言编写插件,通过容器注册表分发它们,并可以在任何地方运行——从云端到边缘设备。

特性

  • 使用编译成WebAssembly的任何语言编写插件
  • 通过标准OCI注册表(如Docker Hub)分发插件
  • 基于Extism,提供可靠的插件支持
  • 使用WASM进行沙箱化:能够限制网络、文件系统和内存访问
  • 轻量级,适合资源受限的环境
  • 支持规范中的所有三种协议:stdiossestreamble-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凭证)
  1. 启动服务器:
$ hyper-mcp
  • 默认情况下,它将使用stdio传输。如果您想使用SSE,请使用标志--transport sse或使用流式HTTP与--transport streamable-http
  • 如果您想调试,请使用RUST_LOG=info
  • 如果您正在加载未签名的OCI插件,您需要设置insecure_skip_signature标志或环境变量HYPER_MCP_INSECURE_SKIP_SIGNATUREtrue

与Cursor IDE一起使用

您可以为所有项目全局配置hyper-mcp,也可以为个别项目单独配置。

  1. 对于项目范围的配置,在项目根目录下创建.cursor/mcp.json
{
  "mcpServers": {
    "hyper-mcp": {
      "command": "/path/to/hyper-mcp"
    }
  }
}
  1. 在Cursor的设置中设置hyper-mcp: cursor mcp

  2. 通过聊天开始使用工具: cursor mcp chat

可用插件

我们维护了一些示例插件来帮助您入门:

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格式提供,非常适合在线对称加密。

文档

  • 运行时配置指南 - 包括以下内容的全面指南:
    • 身份验证设置(基本、令牌和密钥环)
    • 插件运行时配置
    • 安全注意事项和最佳实践
    • macOS、Linux和Windows特定的密钥环设置
    • 身份验证问题的故障排除
  • 跳过工具模式指南 - 使用正则表达式模式过滤工具的全面指南:
    • 模式语法和示例
    • 常见用例和最佳实践
    • 环境特定的过滤策略
    • 高级正则表达式技术
    • 迁移和故障排除

创建插件

有关创建插件的详细说明,请参阅CREATING_PLUGINS.md

许可证

Apache 2.0

星标历史

星标历史图表