Hyper

Hyper MCP runs WebAssembly-based plugins to extend MCP-compatible clients with AI capabilities. It loads plugins from OCI registries or local files, sandboxing them for safety, and exposes a fast, secure MCP server you can deploy anywhere from cloud to edge.

How to use

You operate Hyper MCP as a local server that your MCP clients connect to. By default it uses the stdio transport, which means you interact with it through standard input/output channels. If you want lower-latency streaming or different transport methods, you can switch to SSE or streamable HTTP.

Configure your plugins first. Create a config file that lists the plugins you want to load, each with its OCI URL or local path. The server will preload these plugins at startup and sandbox them according to runtime limits you set.

When you’re ready to start, run the server and point clients to it. The server supports loading plugins from multiple sources and enforcing access controls for each host function. Here is a typical startup flow: load the config, start hyper-mcp, and connect your MCP client to the server endpoint.

How to install

Prerequisites you need before installing Hyper MCP are your target platform (Linux, macOS, or Windows) and a runtime for running the server binary.

# Install steps assume you obtain the Hyper MCP binary from a trusted source
# 1. Create your config directory if needed
mkdir -p "$HOME/.config/hyper-mcp" 

# 2. Create your config.json with your plugins (see config example below)
# 3. Start the server
hyper-mcp

If you need to debug, enable verbose logs by setting the environment variable before starting the server.

Configuration and runtime options

You can specify a list of plugins and their sources in a JSON configuration. Each plugin entry includes the plugin name and the URL to load it from. You can also add runtime constraints like allowed hosts or memory limits per plugin.

{
  "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"}}
  }
}

Transport options

The server supports all three transport protocols defined in the MCP spec. By default you get stdio. To use SSE, start with the flag --transport sse. To use streamable HTTP, start with --transport streamable-http.

Available tools

time

Get current time and perform time calculations within plugins (Rust)

qr_code

Generate QR codes from data (Rust)

hash

Compute various hash functions (Rust)

myip

Return your public IP address (Rust)

fetch

Fetch a webpage or resource (Rust)

crypto_price

Query cryptocurrency prices (Go)

fs

File system operations (Rust)

github

GitHub plugin (Go)

eval_py

Evaluate Python code with RustPython (Rust)

arxiv

Search and download arXiv papers (Rust)

memory

Store and retrieve memory using SQLite (Rust)

sqlite

Interact with SQLite databases (Rust)

crates-io

Get crate information (Rust)

gomodule

Get Go module info (Rust)

qdrant

Memory storage with Qdrant vector search (Rust)

gitlab

GitLab plugin (Rust)

meme_generator

Create memes from templates (Rust)

context7

Lookup library documentation (Rust)

think

Think tool for reasoning (Rust)

maven

Maven project plugin (Rust)

serper

Serper web search plugin (Rust)

rstime

Get current time and perform time calculations (Rust)