Hyper MCP server

hyper-mcp is a fast, secure MCP server that extends AI capabilities through WebAssembly plugins. It's compatible with Claude Desktop, Cursor IDE, and other MCP-compatible applications, allowing you to write plugins in any language that compiles to WebAssembly and distribute them through container registries.

Installation

Setting Up Configuration

First, create your configuration file in the appropriate location based on your operating system:

• Linux: $HOME/.config/hyper-mcp/config.json
• macOS: $HOME/Library/Application Support/hyper-mcp/config.json
• Windows: C:\Users\[Username]\AppData\Roaming\hyper-mcp\config.json

Here's a sample configuration:

{
  "plugins": [
    {
      "name": "time",
      "url": "oci://ghcr.io/tuananh/time-plugin:latest"
    },
    {
      "name": "qr-code",
      "url": "oci://ghcr.io/tuananh/qrcode-plugin:latest"
    },
    {
      "name": "hash",
      "url": "oci://ghcr.io/tuananh/hash-plugin:latest"
    },
    {
      "name": "myip",
      "url": "oci://ghcr.io/tuananh/myip-plugin:latest",
      "runtime_config": {
        "allowed_hosts": ["1.1.1.1"]
      }
    },
    {
      "name": "fetch",
      "url": "oci://ghcr.io/tuananh/fetch-plugin:latest",
      "runtime_config": {
        "allowed_hosts": ["*"],
        "memory_limit": "100 MB",
        "tool_name_prefix": "foo_"
      }
    }
  ]
}

Supported URL Schemes

You can load plugins from various sources:

• oci:// - OCI-compliant registries (Docker Hub, GitHub Container Registry, etc.)
• file:// - Local files
• http:// or https:// - Remote files
• s3:// - Amazon S3 objects (requires AWS credentials in your environment)

Starting the Server

Once your configuration is set, start the server with:

hyper-mcp

Additional options:

• For SSE transport: hyper-mcp --transport sse
• For streamable HTTP: hyper-mcp --transport streamable-http
• For debug logging: RUST_LOG=info hyper-mcp
• For loading unsigned OCI plugins: Set insecure_skip_signature flag or environment variable HYPER_MCP_INSECURE_SKIP_SIGNATURE=true

Usage

Using with Cursor IDE

You can configure hyper-mcp for Cursor IDE at either the project or global level.

Project-Specific Configuration

Create a .cursor/mcp.json file in your project root:

{
  "mcpServers": {
    "hyper-mcp": {
      "command": "/path/to/hyper-mcp"
    }
  }
}

Configure in Cursor Settings

Set up hyper-mcp in Cursor's settings interface, then start using the tools through the chat interface.

Available Plugins

hyper-mcp offers several pre-built plugins:

• time: Get current time and perform time calculations (Rust)
• qr-code: Generate QR codes (Rust)
• hash: Generate various hash types (Rust)
• myip: Get your current IP address (Rust)
• fetch: Basic webpage fetching (Rust)
• crypto-price: Get cryptocurrency prices (Go)
• fs: File system operations (Rust)
• github: GitHub integration (Go)
• eval-py: Evaluate Python code with RustPython (Rust)
• arxiv: Search and download arXiv papers (Rust)
• memory: Store and retrieve data with SQLite (Rust)
• sqlite: Interact with SQLite databases (Rust)
• crates-io: Get Rust crate information (Rust)
• gomodule: Get Go modules information (Rust)
• qdrant: Manage memories in Qdrant vector search engine (Rust)
• gitlab: GitLab integration (Rust)
• meme-generator: Generate memes (Rust)
• context7: Look up library documentation (Rust)
• think: Think tool (Rust)
• maven: Maven plugin (Rust)
• serper: Serper web search plugin (Rust)

Community-Built Plugins

Several community plugins are also available:

• hackernews: Fetch top stories from Hacker News
• release-monitor-id: Retrieve project IDs from release-monitoring.org
• yahoo-finance: Get stock prices from Yahoo Finance
• rand16: Generate random 16-byte buffers in base64uri format

Creating Custom Plugins

Setting Up Development Environment

1. Install the XTP CLI:

curl https://static.dylibso.com/cli/install.sh -s | bash

2. Create a new plugin project:

xtp plugin init --schema-file plugin-schema.yaml

3. Implement your plugin logic in the appropriate files (e.g., src/lib.rs for Rust)

Publishing Plugins

Create a Dockerfile to build your plugin:

# Example for Rust plugins
FROM rust:1.88-slim AS builder

RUN rustup target add wasm32-wasip1 && \
    rustup component add rust-std --target wasm32-wasip1 && \
    cargo install cargo-auditable

WORKDIR /workspace
COPY . .
RUN cargo fetch
RUN cargo auditable build --release --target wasm32-wasip1

FROM scratch
WORKDIR /
COPY --from=builder /workspace/target/wasm32-wasip1/release/plugin.wasm /plugin.wasm

Build and push your container:

docker build -t your-registry/plugin-name .
docker push your-registry/plugin-name

Then add your plugin to the hyper-mcp configuration file to make it available.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "hyper-mcp" '{"command":"/path/to/hyper-mcp"}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "hyper-mcp": {
            "command": "/path/to/hyper-mcp"
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "hyper-mcp": {
            "command": "/path/to/hyper-mcp"
        }
    }
}

3. Restart Claude Desktop for the changes to take effect