Skip to content
Back to search

hyper-mcp

πŸ“¦οΈ A fast, secure MCP server that extends its capabilities through WebAssembly plugins.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/hyper-mcp-rs/hyper-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/hyper-mcp-rs/hyper-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hyper-mcp-rs--hyper-mcp/badge.svg)](/listings/hyper-mcp-rs--hyper-mcp)

HTML

<a href="/listings/hyper-mcp-rs--hyper-mcp"><img src="/api/listings/hyper-mcp-rs--hyper-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

**cosign** β€” required for loading plugins from OCI registries (`oci://` URLs).

hyper-mcp verifies the cryptographic signature of every OCI plugin before loading it to ensure the plugin has not been tampered with and comes from a trusted source. This verification is performed by shelling out to the [cosign](https://github.com/sigstore/cosign) CLI, which must be installed and available on your `PATH`.

Install cosign by following the official instructions: **<https://docs.sigstore.dev/cosign/system_config/installation/>**

> **Note:** If you only use `file://`, `http://`, `https://`, or `s3://` plugin URLs, cosign is not needed. You can also bypass signature verification for OCI plugins by setting `insecure_skip_signature: true` in your config or the `HYPER_MCP_INSECURE_SKIP_SIGNATURE=true` environment variable, but this is **not recommended** for production use.

Install from Homebrew

hyper-mcp is published on Homebrew for macOS and Linux in two places:

**Homebrew core** β€” no tap setup required:

brew install hyper-mcp

**Our own tap (`hyper-mcp-rs/tap`)** β€” bumped automatically on every GitHub Release, so it picks up new versions immediately:

brew install hyper-mcp-rs/tap/hyper-mcp

Both install the same binary. Prefer the core formula unless you want the absolute latest release the moment it ships.

Pre-built binaries (GitHub Releases)

Download the latest release for your platform from [GitHub Releases](https://github.com/hyper-mcp-rs/hyper-mcp/releases):

Chose the version that you want and download the architecture-specific binary.

| Platform | Architecture | Download | |---|---|---| | macOS | Apple Silicon (ARM64) | hyper-mcp-aarch64-apple-darwin.tar.gz | | Linux | ARM64 | hyper-mcp-aarch64-unknown-linux-gnu.tar.gz | | Linux | x86_64 | hyper-mcp-x86_64-unknown-linux-gnu.tar.gz | | Windows | x86_64 | hyper-mcp-x86_64-pc-windows-msvc.zip |

**macOS / Linux:**

Donwload the `.tar.gz` file, extract it, and place `hyper-mcp` in `/usr/local/bin`.

**Windows:**

Download the `.zip` file, extract it, and place `hyper-mcp.exe` somewhere on your `PATH`.

Install from crates.io

If you have [Rust](https://rustup.rs/) installed, you can install hyper-mcp directly from [crates.io](https://crates.io/crates/hyper-mcp):

cargo install hyper-mcp

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json Β· Manifest Β· 19 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "hyper-mcp-rs",
  3. "owner": {
  4. "name": "hyper-mcp-rs",
  5. "email": "me@tuananh.org"
  6. },
  7. "description": "WebAssembly-plugin MCP servers from the hyper-mcp project",
  8. "plugins": [
  9. {
  10. "name": "hyper-mcp",
  11. "source": "./plugins/hyper-mcp",
  12. "description": "A fast, secure MCP server that extends its capabilities through WebAssembly plugins",
  13. "license": "Apache-2.0",
  14. "homepage": "https://github.com/hyper-mcp-rs/hyper-mcp",
  15. "repository": "https://github.com/hyper-mcp-rs/hyper-mcp",
  16. "keywords": ["mcp", "wasm", "plugins", "rust"]
  17. }
  18. ]
  19. }
README.md Β· README Β· 342 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <picture>
  3. <img alt="hyper-mcp logo" src="./assets/logo.png" width="50%">
  4. </picture>
  5. </div>
  6. <div align="center">
  7. [![Rust](https://img.shields.io/badge/rust-%23000000.svg?logo=rust&logoColor=white)](https://crates.io/crates/hyper-mcp)
  8. [![License](https://img.shields.io/badge/License-Apache--2.0-blue)](#license)
  9. [![Issues - hyper-mcp](https://img.shields.io/github/issues/hyper-mcp-rs/hyper-mcp)](https://github.com/hyper-mcp-rs/hyper-mcp/issues)
  10. ![GitHub Release](https://img.shields.io/github/v/release/hyper-mcp-rs/hyper-mcp)
  11. <a href="https://trendshift.io/repositories/13451" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13451" alt="hyper-mcp-rs%2Fhyper-mcp | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
  12. </div>
  13. # hyper-mcp
  14. A fast, secure MCP server that extends its capabilities through WebAssembly plugins.
  15. ## What is it?
  16. hyper-mcp makes it easy to add AI capabilities to your applications. It works with Claude Desktop, Cursor IDE, and other MCP-compatible apps. Write plugins in your favorite language, distribute them through container registries, and run them anywhere - from cloud to edge.
  17. ## Features
  18. - Write plugins in any language that compiles to WebAssembly
  19. - Distribute plugins via standard OCI registries (like Docker Hub)
  20. - Built on [Extism](https://github.com/extism/extism) for rock-solid plugin support
  21. - Sanboxing with WASM: ability to limit network, filesystem, memory access
  22. - Lightweight enough for resource-constrained environments
  23. - Support `stdio` transport protocol
  24. - Deploy anywhere: serverless, edge, mobile, IoT devices
  25. - Cross-platform compatibility out of the box
  26. - Support tool name prefix to prevent tool names collision
  27. - Dynamic plugin loading and unloading (configurable)
  28. ## Security
  29. Built with security-first mindset:
  30. - Sandboxed plugins that can't access your system without permission
  31. - Memory-safe execution with resource limits
  32. - Secure plugin distribution through container registries
  33. - Fine-grained access control for host functions
  34. - OCI plugin images are signed at publish time and verified at load time with [sigstore](https://www.sigstore.dev/).
  35. ## Installation
  36. ### Prerequisites
  37. **cosign** β€” required for loading plugins from OCI registries (`oci://` URLs).
  38. hyper-mcp verifies the cryptographic signature of every OCI plugin before loading it to ensure the plugin has not been tampered with and comes from a trusted source. This verification is performed by shelling out to the [cosign](https://github.com/sigstore/cosign) CLI, which must be installed and available on your `PATH`.
  39. Install cosign by following the official instructions: **<https://docs.sigstore.dev/cosign/system_config/installation/>**
  40. > **Note:** If you only use `file://`, `http://`, `https://`, or `s3://` plugin URLs, cosign is not needed. You can also bypass signature verification for OCI plugins by setting `insecure_skip_signature: true` in your config or the `HYPER_MCP_INSECURE_SKIP_SIGNATURE=true` environment variable, but this is **not recommended** for production use.
  41. ### Install from Homebrew
  42. hyper-mcp is published on Homebrew for macOS and Linux in two places:
  43. **Homebrew core** β€” no tap setup required:
  44. ```sh
  45. brew install hyper-mcp
  46. ```
  47. **Our own tap (`hyper-mcp-rs/tap`)** β€” bumped automatically on every GitHub Release, so it picks up new versions immediately:
  48. ```sh
  49. brew install hyper-mcp-rs/tap/hyper-mcp
  50. ```
  51. Both install the same binary. Prefer the core formula unless you want the absolute latest release the moment it ships.
  52. ### Pre-built binaries (GitHub Releases)
  53. Download the latest release for your platform from [GitHub Releases](https://github.com/hyper-mcp-rs/hyper-mcp/releases):
  54. Chose the version that you want and download the architecture-specific binary.
  55. | Platform | Architecture | Download |
  56. |---|---|---|
  57. | macOS | Apple Silicon (ARM64) | hyper-mcp-aarch64-apple-darwin.tar.gz |
  58. | Linux | ARM64 | hyper-mcp-aarch64-unknown-linux-gnu.tar.gz |
  59. | Linux | x86_64 | hyper-mcp-x86_64-unknown-linux-gnu.tar.gz |
  60. | Windows | x86_64 | hyper-mcp-x86_64-pc-windows-msvc.zip |
  61. **macOS / Linux:**
  62. Donwload the `.tar.gz` file, extract it, and place `hyper-mcp` in `/usr/local/bin`.
  63. **Windows:**
  64. Download the `.zip` file, extract it, and place `hyper-mcp.exe` somewhere on your `PATH`.
  65. ### Install from crates.io
  66. If you have [Rust](https://rustup.rs/) installed, you can install hyper-mcp directly from [crates.io](https://crates.io/crates/hyper-mcp):
  67. ```sh
  68. cargo install hyper-mcp
  69. ```
  70. ## Getting Started
  71. 1. Create your config file:
  72. - Linux: `$HOME/.config/hyper-mcp/config.json`
  73. - Windows: `{FOLDERID_RoamingAppData}\hyper-mcp\config.json`. Eg: `C:\Users\Alice\AppData\Roaming\hyper-mcp\config.json`
  74. - macOS: `$HOME/Library/Application Support/hyper-mcp/config.json`
  75. ```json
  76. {
  77. "plugins": {
  78. "time": {
  79. "url": "oci://ghcr.io/hyper-mcp-rs/time-plugin:latest",
  80. "description": "Get current time and do time calculations"
  81. },
  82. "qr_code": {
  83. "url": "oci://ghcr.io/hyper-mcp-rs/qrcode-plugin:latest",
  84. "description": "Generate QR codes from text"
  85. },
  86. "hash": {
  87. "url": "oci://ghcr.io/hyper-mcp-rs/hash-plugin:latest"
  88. },
  89. "myip": {
  90. "url": "oci://ghcr.io/hyper-mcp-rs/myip-plugin:latest",
  91. "description": "Get your current public IP address",
  92. "runtime_config": {
  93. "allowed_hosts": ["1.1.1.1"]
  94. }
  95. },
  96. "fetch": {
  97. "url": "oci://ghcr.io/hyper-mcp-rs/fetch-plugin:latest",
  98. "runtime_config": {
  99. "allowed_hosts": ["*"],
  100. "memory_limit": "100 MB",
  101. }
  102. }
  103. }
  104. }
  105. ```
  106. > πŸ“– **For detailed configuration options including authentication setup, runtime configuration, and advanced features, see [RUNTIME_CONFIG.md](./RUNTIME_CONFIG.md)**
  107. Supported URL schemes:
  108. - `oci://` - for OCI-compliant registries (like Docker Hub, GitHub Container Registry, etc.). Requires [cosign](https://docs.sigstore.dev/cosign/system_config/installation/) for signature verification (see [Prerequisites](#prerequisites))
  109. - `file://` - for local files
  110. - `http://` or `https://` - for remote files
  111. - `s3://` - for Amazon S3 objects (requires that you have your AWS credentials set up in the environment)
  112. 2. Start the server:
  113. ```sh
  114. $ hyper-mcp
  115. ```
  116. - Uses `stdio` transport protocol.
  117. - If you want to debug, use `RUST_LOG=debug`.
  118. - If you're loading unsigned OCI plugin, you need to set `insecure_skip_signature` flag or env var `HYPER_MCP_INSECURE_SKIP_SIGNATURE` to `true`
  119. > **Running in SSE/streamable-http**: To do this, wrap `hyper-mcp` in one of the many proxies that supports the network transports **AND** that creates an instance of `hyper-mcp` per client connection.
  120. ## Output Logging
  121. hyper-mcp automatically logs all output to daily rolling log files for debugging and monitoring purposes.
  122. **Log Location:**
  123. - Linux: `$HOME/.config/hyper-mcp/logs/mcp-server.log`
  124. - Windows: `{FOLDERID_RoamingAppData}\hyper-mcp\logs\mcp-server.log`
  125. - macOS: `$HOME/Library/Application Support/hyper-mcp/logs/mcp-server.log`
  126. **Custom Log Path:**
  127. You can override the default log directory by setting the `HYPER_MCP_LOG_PATH` environment variable:
  128. ```sh
  129. export HYPER_MCP_LOG_PATH=/path/to/your/logs
  130. hyper-mcp
  131. ```
  132. **Log Levels:**
  133. Control the verbosity of logs using the `RUST_LOG` environment variable:
  134. ```sh
  135. # Info level (default)
  136. RUST_LOG=info hyper-mcp
  137. # Debug level (verbose, useful for troubleshooting)
  138. RUST_LOG=debug hyper-mcp
  139. # Warn level (only warnings and errors)
  140. RUST_LOG=warn hyper-mcp
  141. ```
  142. **Features:**
  143. - Daily log rotation (new file created each day)
  144. - Non-blocking writes to prevent performance impact
  145. - Includes timestamps, line numbers, and target information
  146. - Safe for use with stdio transport (logs don't interfere with MCP communication)
  147. ## Using with Cursor IDE
  148. You can configure hyper-mcp either globally for all projects or specifically for individual projects.
  149. 1. For project-scope configuration, create `.cursor/mcp.json` in your project root:
  150. ```json
  151. {
  152. "mcpServers": {
  153. "hyper-mcp": {
  154. "command": "/path/to/hyper-mcp"
  155. }
  156. }
  157. }
  158. ```
  159. 2. Set up hyper-mcp in Cursor's settings:
  160. ![cursor mcp](./assets/cursor-mcp.png)
  161. 3. Start using tools through chat:
  162. ![cursor mcp chat](./assets/cursor-mcp-1.png)
  163. ## Using with Claude Desktop
  164. Every [GitHub Release](https://github.com/hyper-mcp-rs/hyper-mcp/releases) ships an **MCP Bundle** (`.mcpb`) for each platform alongside the raw binaries:
  165. | Platform | Bundle |
  166. |---|---|
  167. | macOS (Apple Silicon) | `hyper-mcp-aarch64-apple-darwin.mcpb` |
  168. | Linux (x86_64) | `hyper-mcp-x86_64-unknown-linux-gnu.mcpb` |
  169. | Linux (ARM64) | `hyper-mcp-aarch64-unknown-linux-gnu.mcpb` |
  170. | Windows (x86_64) | `hyper-mcp-x86_64-pc-windows-msvc.mcpb` |
  171. Download the bundle for your platform and double-click it (or drag it into Claude Desktop) to get a one-click install dialog. Claude Desktop will prompt you for:
  172. - **Plugin config file** β€” path to your `config.json`/`config.yaml` listing the WASM plugins to load (see [Getting Started](#getting-started) and [`config.example.json`](./config.example.json)).
  173. - **Enable dynamic plugin loading** (optional).
  174. - **Skip OCI signature verification** (optional, not recommended).
  175. > The bundle contains only the `hyper-mcp` binary. Loading `oci://` plugins still requires [cosign](#prerequisites) on your `PATH` unless you enable "Skip OCI signature verification".
  176. The bundle manifest lives in [`mcpb/manifest.json`](./mcpb/manifest.json) and is packed per-platform by the release workflow.
  177. ## Using with Claude Code
  178. The quickest way is a direct add (requires `hyper-mcp` already installed via Homebrew/cargo):
  179. ```sh
  180. claude mcp add hyper-mcp -- hyper-mcp --config-file /path/to/config.json
  181. ```
  182. Or install it from our plugin marketplace:
  183. ```text
  184. /plugin marketplace add hyper-mcp-rs/hyper-mcp
  185. /plugin install hyper-mcp@hyper-mcp-rs
  186. /reload-plugins
  187. ```
  188. The marketplace catalog ([`.claude-plugin/marketplace.json`](./.claude-plugin/marketplace.json)) and plugin ([`plugins/hyper-mcp`](./plugins/hyper-mcp)) live in this repo. See the [plugin README](./plugins/hyper-mcp/README.md) for prerequisites and configuration.
  189. ## Available Plugins
  190. We maintain several plugins to get you started:
  191. ### V1 Plugins
  192. These plugins use the v1 plugin interface. While still supported, new plugins should use the v2 interface.
  193. - [time](https://github.com/hyper-mcp-rs/time-plugin): Get current time and do time calculations (Rust)
  194. - [qr_code](https://github.com/hyper-mcp-rs/qr-code-plugin): Generate QR codes (Rust)
  195. - [hash](https://github.com/hyper-mcp-rs/hash-plugin): Generate various types of hashes (Rust)
  196. - [myip](https://github.com/hyper-mcp-rs/myip-plugin): Get your current IP (Rust)
  197. - [crypto_price](https://github.com/hyper-mcp-rs/crypto-price-plugin): Get cryptocurrency prices (Go)
  198. - [fs](https://github.com/hyper-mcp-rs/fs-plugin): File system operations (Rust)
  199. - [github](https://github.com/hyper-mcp-rs/github-plugin): GitHub plugin (Go)
  200. - [eval_py](https://github.com/hyper-mcp-rs/eval-py-plugin): Evaluate Python code with RustPython (Rust)
  201. - [memory](https://github.com/hyper-mcp-rs/memory-plugin): Let you store & retrieve memory, powered by SQLite (Rust)
  202. - [crates-io](https://github.com/hyper-mcp-rs/crates-io-plugin): Get crate general information, check crate latest version (Rust)
  203. - [gomodule](https://github.com/hyper-mcp-rs/gomodule-plugin): Get Go modules info, version (Rust)
  204. - [qdrant](https://github.com/hyper-mcp-rs/qdrant-plugin): keeping & retrieving memories to Qdrant vector search engine (Rust)
  205. - [gitlab](https://github.com/hyper-mcp-rs/gitlab-plugin): GitLab plugin (Rust)
  206. - [meme_generator](https://github.com/hyper-mcp-rs/meme-generator-plugin): Meme generator (Rust)
  207. - [think](https://github.com/hyper-mcp-rs/think-plugin): Think tool(Rust)
  208. - [maven](https://github.com/hyper-mcp-rs/maven-plugin): Maven plugin (Rust)
  209. - [serper](https://github.com/hyper-mcp-rs/serper-plugin): Serper web search plugin (Rust)
  210. ### V2 Plugins
  211. These plugins use the v2 plugin interface. New plugins should use this interface.
  212. - [arxiv](https://github.com/hyper-mcp-rs/arxiv-plugin): Search arXiv papers (Rust)
  213. - [context7](https://github.com/hyper-mcp-rs/context7-plugin): Lookup library documentation (Rust)
  214. - [defuddle](https://github.com/hyper-mcp-rs/defuddle-plugin): Get the main content of any page as Markdown (Rust)
  215. - [fetch](https://github.com/hyper-mcp-rs/fetch-plugin): Basic webpage fetching (Rust)
  216. - [monty](https://github.com/hyper-mcp-rs/monty-plugin): A minimal, secure Python interpreter written in Rust for use by AI (Rust)
  217. - [rstime](https://github.com/hyper-mcp-rs/rstime-plugin): Get current time and do time calculations (Rust)
  218. - [sqlite](https://github.com/hyper-mcp-rs/sqlite-plugin): Interact with SQLite (Rust)
  219. ### Community-built plugins
  220. - [hackernews](https://github.com/hungran/hyper-mcp-hackernews-tool): This plugin connects to the Hacker News API to fetch the current top stories and display them with their titles, scores, authors, and URLs.
  221. - [release-monitor-id](https://github.com/ntheanh201/hyper-mcp-release-monitor-id-tool): This plugin retrieves project ID from release-monitoring.org, which helps track versions of released software.
  222. - [yahoo-finance](https://github.com/phamngocquy/hyper-mcp-yfinance): This plugin connects to the Yahoo Finance API to provide stock prices (OHLCV) based on a company name or ticker symbol.
  223. - [rand16](https://github.com/dabevlohn/rand16): This plugen generates random 16 bytes buffer and provides it in base64uri format - very usable for symmetric cryptography online.
  224. ## Documentation
  225. - **[Built-in Tools Reference](./BUILT_IN_TOOLS.md)** - Documentation for the `hyper_mcp-*` tools including:
  226. - `hyper_mcp-list_plugins` β€” list all loaded plugins
  227. - `hyper_mcp-load_plugin` β€” dynamically load a plugin at runtime
  228. - `hyper_mcp-unload_plugin` β€” dynamically unload a plugin at runtime
  229. - **[Runtime Configuration Guide](./RUNTIME_CONFIG.md)** - Comprehensive guide to configuration options including:
  230. - Authentication setup (Basic, Token, and Keyring)
  231. - Plugin runtime configuration
  232. - Security considerations and best practices
  233. - Platform-specific keyring setup for macOS, Linux, and Windows
  234. - Troubleshooting authentication issues
  235. - **[Skip Tools Pattern Guide](./SKIP_TOOLS_GUIDE.md)** - Comprehensive guide to filtering tools using regex patterns:
  236. - Pattern syntax and examples
  237. - Common use cases and best practices
  238. - Environment-specific filtering strategies
  239. - Advanced regex techniques
  240. - Migration and troubleshooting
  241. ## Creating Plugins
  242. For comprehensive instructions on creating plugins, see [CREATING_PLUGINS.md](./CREATING_PLUGINS.md).
  243. For ready-to-use plugin templates in Rust and Go, see [TEMPLATES.md](./TEMPLATES.md).
  244. ## License
  245. [Apache 2.0](./LICENSE)
  246. ## Star History
  247. [![Star History Chart](https://api.star-history.com/svg?repos=hyper-mcp-rs/hyper-mcp&type=Date)](https://www.star-history.com/#hyper-mcp-rs/hyper-mcp&Date)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.