hyper-mcp

by kranners
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides integration with Hyper terminals through a configurable MCP server wrapper, enabling unlimited tool usage in Cursor without the standard tool count limit.

  • Uses Zod schema validation to ensure proper configuration format, providing reliable validation of MCP configuration files.

hyper-mcp

A configurable MCP server wrapper for using the entire Model Context Protocol without a tool count limit in Cursor.

Installation

  1. Start by making a backup of your current mcp.json file.

    Tip

    The default location is ~/.cursor/hyper.mcp.json. To rename your existing Cursor config: mv ~/.cursor/mcp.json ~/.cursor/hyper.mcp.json

  2. Create a new mcp.json file where the old one was, with these contents:
{ "mcpServers": { "hyper": { "command": "npx", "args": [ "@cute-engineer/hyper-mcp", "/path/to/hyper.mcp.json" ], "env": { "CONFIG_PATH": "/path/to/hyper.mcp.json", } } } }

The server will prefer arguments over environment variables over ~/.cursor/hyper.mcp.json.

TODO

Need to:

  • Read in the config file (mcp.json), can take in an argument or a env var
  • Validate it's in the correct format (zod schema)

Startup

  • Load a new client for each MCP entry
  • List all tools
  • Add all those to a register

Runtime

  • Expose that list via the tools endpoint
  • Take in commands
  • Forward them through to the respective MCP server
  • Forward the results back

Support

  • Update transport command to support Nix, etc
  • Update connections to pass through MCP host environment (is this needed?)

Spice

  • CI & releases
  • Support SSE servers
  • Also load all prompts & resources
  • Optionally blacklist or prefer tools
  • Expose all of the other things as well
  • Instructions tool, configurable help message
  • Templatable help message?
-
security - not tested
A
license - permissive license
-
quality - not tested

A configurable MCP server wrapper for Cursor that eliminates tool count limits when using the Model Context Protocol.

  1. Installation
    1. TODO
      1. Startup
      2. Runtime
      3. Support
      4. Spice
    ID: bzw9wynuc8