Grey Hack MCP Server

Servidor MCP de Grey Hack

Un servidor de Model Context Protocol (MCP) para el desarrollo del juego Grey Hack, diseñado para funcionar con Cursor IDE y otras herramientas compatibles con MCP.

Características

• Búsqueda de Código en GitHub: Encuentra ejemplos de código de Grey Hack en repositorios de GitHub
• Transpilación Greybel-JS: Convierte GreyScript a JavaScript
• Validación de API de GreyScript: Valida código contra la API oficial de Grey Hack
• Generación de Scripts: Genera scripts de plantilla para tareas comunes del juego

Instalación

Requisitos previos

• Node.js 18+ instalado
• Cursor IDE u otro editor compatible con MCP
• Token de API de GitHub (para la funcionalidad de búsqueda de código)

Instalar desde NPM

npm install -g @chromewillow/greyhack-mcp-server

Instalación manual

Clona el repositorio e instala las dependencias:

git clone https://github.com/chromewillow/greyhack-mcp-server.git
cd greyhack-mcp-server
npm install
npm run build

Uso con Cursor IDE

Usando archivo de configuración

Crea un archivo .cursor/mcp.json en tu espacio de trabajo con el siguiente contenido:

{
  "mcpServers": {
    "@greyhack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@chromewillow/greyhack-mcp-server",
        "--config",
        "{\"GITHUB_TOKEN\":\"your-github-token-here\"}"
      ]
    }
  }
}

Configuración manual en Cursor

1. Abre la configuración de Cursor (Cmd/Ctrl + ,)
2. Navega a Features → MCP
3. Haz clic en "+ Add New MCP Server"
4. Ingresa los siguientes detalles:
   • Nombre: greyhack-mcp-server
   • Comando: npx
   • Argumentos: -y @smithery/cli@latest run @chromewillow/greyhack-mcp-server
   • Variables de entorno: GITHUB_TOKEN=your-github-token-here

Herramientas disponibles

1. Búsqueda de Código en GitHub

Busca ejemplos de código de Grey Hack en GitHub:

Use the search_greyhack_code tool to find examples of port scanners in Grey Hack

2. Transpilación Greybel-JS

Convierte código GreyScript a JavaScript:

Use the transpile_greyscript tool to convert this Grey Hack code to JavaScript:
get_shell.host_computer.File("/home/user/test.txt")

3. Validación de API de GreyScript

Valida tu código contra la API de Grey Hack:

Use the validate_greyscript tool to check if this code is valid in Grey Hack 0.8.0:
router = get_router
ip = router.local_ip

4. Generación de Scripts

Genera scripts de plantilla para tareas comunes del juego:

Use the generate_greyhack_script tool to create a port scanner for Grey Hack 0.8.0

Tipos de scripts disponibles:

• port_scanner: Utilidad de escaneo de puertos de red
• password_cracker: Herramienta de descifrado de contraseñas
• file_browser: Utilidad de navegación y manipulación de archivos
• ssh_tool: Utilidad de conexión SSH
• custom: Plantilla de script personalizado (requiere descripción)

Desarrollo

Compilación desde el código fuente

npm run build

Ejecución en modo de desarrollo

npm run dev

Licencia

MIT

Agradecimientos

Este proyecto utiliza:

• Model Context Protocol TypeScript SDK
• Smithery GitHub Client
• Axios para solicitudes HTTP