tuananh_hyper_mcp
by tuananhHyper MCP Server with WebAssembly Plugins
Overview
Hyper MCP Server is a fast, secure MCP server that extends its capabilities through WebAssembly plugins. It integrates seamlessly with tools like Claude Desktop and Cursor IDE, enabling developers to add AI capabilities to their applications. The server supports plugins written in any language that compiles to WebAssembly, distributed via standard OCI registries like Docker Hub.
Features
- WebAssembly Plugin Support: Write plugins in any language that compiles to WebAssembly.
- OCI Registry Distribution: Distribute plugins via standard OCI registries.
- Built on Extism: Rock-solid plugin support powered by Extism.
- Lightweight: Designed for resource-constrained environments.
- Cross-Platform Compatibility: Deploy anywhere, from serverless to edge and IoT devices.
Security
Hyper MCP is built with a security-first mindset:
- Sandboxed Plugins: Plugins cannot access your system without permission.
- Memory-Safe Execution: Resource limits ensure safe execution.
- Secure Distribution: Plugins are distributed securely through container registries.
- Fine-Grained Access Control: Host functions are controlled with precision.
Getting Started
Configuration
- Create your config file:
- Linux/Windows:
$HOME/.config/hyper-mcp/config.json - macOS:
$HOME/Library/Application Support/hyper-mcp/config.json
Example config.json:
{
"plugins": [
{
"name": "time",
"path": "oci://ghcr.io/tuananh/time-plugin:latest"
},
{
"name": "qr-code",
"path": "oci://ghcr.io/tuananh/qrcode-plugin:latest"
},
{
"name": "hash",
"path": "oci://ghcr.io/tuananh/hash-plugin:latest"
},
{
"name": "myip",
"path": "oci://ghcr.io/tuananh/myip-plugin:latest",
"runtime_config": {
"allowed_host": "1.1.1.1"
}
},
{
"name": "fetch",
"path": "oci://ghcr.io/tuananh/fetch-plugin:latest",
"runtime_config": {
"allowed_host": "*"
}
}
]
}
- Start the server:
$ hyper-mcp
Using with Cursor IDE
-
Set up Hyper MCP in Cursor's settings:
-
Start using tools through chat:
Available Plugins
We maintain several example plugins to get you started:
- time: Get current time and perform time calculations.
- qr-code: Generate QR codes.
- hash: Generate various types of hashes.
- myip: Get your current IP (example of HTTP requests).
- fetch: Basic webpage fetching.
- crypto-price: Get cryptocurrency prices (Go example).
- fs: File system operations.
Creating Plugins
Check out our example plugins to learn how to build your own.
Publishing a Plugin
Example Dockerfile for building a Rust plugin:
FROM rust:1.85-slim AS builder
RUN rustup target add wasm32-wasip1 && \
rustup component add rust-std --target wasm32-wasip1
WORKDIR /workspace
COPY . .
RUN cargo fetch
RUN cargo build --release --target wasm32-wasip1
FROM scratch
WORKDIR /
COPY --from=builder /workspace/target/wasm32-wasip1/release/your-plugin.wasm /plugin.wasm
Build and push the plugin:
docker build -t your-registry/plugin-name .
docker push your-registry/plugin-name
License
Hyper MCP is licensed under the Apache 2.0 License.
Invite Gmail Contacts
