Grey Hack MCP Server

Servidor MCP Grey Hack

Um servidor Model Context Protocol (MCP) para desenvolvimento de jogos Grey Hack, projetado para funcionar com o Cursor IDE e outras ferramentas compatíveis com MCP.

Recursos

• Pesquisa de Código no GitHub: Encontre exemplos de código Grey Hack em repositórios do GitHub
• Transpilação Greybel-JS: Converta GreyScript para JavaScript
• Validação da API GreyScript: Valide código de acordo com a API oficial do Grey Hack
• Geração de Scripts: Gere scripts de modelo para tarefas comuns do jogo

Instalação

Pré-requisitos

• Node.js 18+ instalado
• Cursor IDE ou outro editor compatível com MCP
• Token da API do GitHub (para a funcionalidade de pesquisa de código)

Instalar via NPM

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

Instalação Manual

Clone o repositório e instale as dependências:

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

Uso com o Cursor IDE

Usando Arquivo de Configuração

Crie um arquivo .cursor/mcp.json no seu espaço de trabalho com o seguinte conteúdo:

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

Configuração Manual no Cursor

1. Abra as configurações do Cursor (Cmd/Ctrl + ,)
2. Navegue até Features → MCP
3. Clique em "+ Add New MCP Server"
4. Insira os seguintes detalhes:
   • Nome: greyhack-mcp-server
   • Comando: npx
   • Argumentos: -y @smithery/cli@latest run @chromewillow/greyhack-mcp-server
   • Variáveis de Ambiente: GITHUB_TOKEN=your-github-token-here

Ferramentas Disponíveis

1. Pesquisa de Código no GitHub

Pesquise exemplos de código Grey Hack no GitHub:

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

2. Transpilação Greybel-JS

Converta código GreyScript para JavaScript:

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

3. Validação da API GreyScript

Valide seu código de acordo com a API do 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. Geração de Scripts

Gere scripts de modelo para tarefas comuns do jogo:

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

Tipos de script disponíveis:

• port_scanner: Utilitário de varredura de portas de rede
• password_cracker: Ferramenta de quebra de senhas
• file_browser: Utilitário de navegação e manipulação de arquivos
• ssh_tool: Utilitário de conexão SSH
• custom: Modelo de script personalizado (requer descrição)

Desenvolvimento

Compilando a partir do Código-Fonte

npm run build

Executando em Modo de Desenvolvimento

npm run dev

Licença

MIT

Agradecimentos

Este projeto utiliza:

• Model Context Protocol TypeScript SDK
• Smithery GitHub Client
• Axios para requisições HTTP