/ Directorio / Playground / hyper-mcp
● Comunidad hyper-mcp-rs ⚡ Instantáneo

hyper-mcp

por hyper-mcp-rs · hyper-mcp-rs/hyper-mcp

Un servidor MCP basado en Rust cuyos tools son plugins WebAssembly — sandboxed, firmados vía OCI y cargados dinámicamente en tiempo de ejecución.

hyper-mcp es un servidor MCP rápido y memory-safe donde cada tool es un plugin WASM extraído de un registro OCI. Los plugins se ejecutan en un sandbox con permisos host-function explícitos, y las firmas se verifican vía sigstore. Ideal para equipos que quieren desplegar tools para agentes sin confiar en paquetes npm aleatorios.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

hyper.replay ▶ listo
0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "hyper": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "hyper": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "hyper": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "hyper": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "hyper",
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "hyper": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add hyper -- TODO 'See README: https://github.com/hyper-mcp-rs/hyper-mcp'

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: hyper-mcp

Cómo desplegar tools MCP internos seguramente con hyper-mcp

👤 Equipos de plataforma que construyen tools de agentes internos ⏱ ~45 min advanced

Cuándo usarlo: Necesitas dar a los ingenieros un conjunto de tools curado y no puedes confiar en que verifiquen cada paquete MCP de npm.

Requisitos previos
  • Binario hyper-mcp instalado — Descarga la versión desde github.com/hyper-mcp-rs/hyper-mcp/releases
  • Un registro OCI para alojar plugins — GHCR o un registro privado Harbor/ECR
Flujo
  1. Publica un plugin firmado
    He construido un plugin WASM en ./my-plugin.wasm. Súbelo a ghcr.io/acme/my-plugin:v1 y firma con sigstore.✓ Copiado
    → Plugin disponible en el registro con firma
  2. Configura hyper-mcp para extraerlo y verificarlo
    Edita ~/.config/hyper-mcp/config.json para añadir la URL del plugin con la identidad del firmante requerida.✓ Copiado
    → El plugin aparece en hyper_mcp-list_plugins después de reiniciar
  3. Llama al tool desde Claude
    Usa el tool expuesto por my-plugin para hacer <X>.✓ Copiado
    → El tool se ejecuta sandboxed; los intentos de exceder las capacidades otorgadas se deniegan

Resultado: Un conjunto de tools interno bloqueado donde cada plugin está firmado, versionado y sandboxed.

Errores comunes
  • Otorgar acceso de red a todos los plugins por defecto — Configura allowed_hosts por plugin; deny-by-default
  • Plugin firmado por la identidad incorrecta — hyper-mcp rechazará — verifica los registros sigstore/rekor para desajuste de firmante

Intercambia tools de agentes en caliente con hyper-mcp sin reiniciar el cliente

👤 Desarrolladores de agentes iterando sobre APIs de tools ⏱ ~10 min intermediate

Cuándo usarlo: Estás probando un tool y quieres iterar sin matar la sesión MCP cada 30 segundos.

Flujo
  1. Carga una nueva versión
    Llama a hyper_mcp-load_plugin con la URL de my-plugin:v2. Confirma que se cargó.✓ Copiado
    → Plugin v2 aparece en list_plugins
  2. Descarga la versión anterior si es necesario
    Llama a hyper_mcp-unload_plugin en my-plugin:v1.✓ Copiado
    → Solo v2 permanece

Resultado: Un loop interno ajustado para el desarrollo de plugins.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

hyper + claude-code

Ejecuta hyper-mcp como el único host MCP dentro de Claude Code y enruta todos los tools personalizados a través de él

Reemplaza mis 5 MCPs basados en npx con hyper-mcp apuntando a mi registro de plugins interno.✓ Copiado
hyper + mcptools

Depura la superficie del tool del plugin antes de que Claude lo vea

Usa tools mcp para enumerar qué está anunciando actualmente hyper-mcp.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
hyper_mcp-list_plugins (ninguno) Inspecciona qué está cargado; depura tools faltantes 0
hyper_mcp-load_plugin url: str (oci://...), name?: str Añade un plugin en tiempo de ejecución una extracción OCI
hyper_mcp-unload_plugin name: str Elimina un plugin — libera memoria y revoca sus tools 0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Ninguno — host local
Tokens por llamada
Depende del plugin — típicamente 100–1000
Monetario
Gratuito; el alojamiento del registro OCI puede costar si es privado
Consejo
Comparte un único host hyper-mcp entre clientes en lugar de ejecutar muchos MCPs basados en npm

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Secretos del plugin inyectados vía config; credenciales del registro OCI vía login estándar docker/ghcr
Salida de datos: Solo a hosts listados en allowed_hosts de cada plugin
No conceder nunca: filesystem sin restricciones network sin restricciones

Resolución de problemas

Errores comunes y soluciones

Plugin falla en la verificación de firma

Verifica que la identidad del firmante de sigstore coincida con config. Vuelve a firmar con cosign sign usando la identidad correcta

Verificar: cosign verify <oci-url>
Plugin se carga pero el tool no es visible para Claude

Claude cachea la lista de tools al iniciar sesión — reinicia el cliente MCP después de cargar

Verificar: hyper_mcp-list_plugins muestra el plugin y sus tools anunciados
Trampa de ejecución WASM / pánico

El plugin excedió un límite de recursos o golpeó una operación unsafe. Verifica logs; aumenta el límite en config solo si es de confianza

Alternativas

hyper-mcp vs otros

AlternativaCuándo usarlaContrapartida
ArcadeCuando quieres un framework Python en lugar de plugins WASMMenos aislamiento; runtime Python en lugar de WASM sandboxed
GolfPython-first, auto-discovery de archivos de toolsNo aislado por plugin; todos los tools se ejecutan en un proceso
FastMCPMCP Python simple, sin necesidades de registro/sandboxSin historia de distribución; redespiegas el servidor completo para cada cambio

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills