Grey Hack MCP Server

A Grey Hack server for Cursor IDE, providing GitHub code search, Greybel-JS transpilation, API validation, and script generation.

View on GitHub →

Grey Hack MCP Server

A Model Context Protocol (MCP) server for Grey Hack game development, designed to work with Cursor IDE and other MCP-compatible tools.

Features

  • GitHub Code Search: Find Grey Hack code examples from GitHub repositories
  • Greybel-JS Transpilation: Convert GreyScript to JavaScript
  • GreyScript API Validation: Validate code against the official Grey Hack API
  • Script Generation: Generate template scripts for common game tasks

Installation

Prerequisites

  • Node.js 18+ installed
  • Cursor IDE or another MCP-compatible editor
  • GitHub API token (for code search functionality)

Install from NPM

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

Manual Installation

Clone the repository and install dependencies:

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

Usage with Cursor IDE

Using Configuration File

Create a .cursor/mcp.json file in your workspace with the following content:

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

Manual Configuration in Cursor

  1. Open Cursor settings (Cmd/Ctrl + ,)
  2. Navigate to Features → MCP
  3. Click "+ Add New MCP Server"
  4. Enter the following details:
    • Name: greyhack-mcp-server
    • Command: npx
    • Arguments: -y @smithery/cli@latest run @chromewillow/greyhack-mcp-server
    • Environment Variables: GITHUB_TOKEN=your-github-token-here

Available Tools

1. GitHub Code Search

Search for Grey Hack code examples on GitHub:

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

2. Greybel-JS Transpilation

Convert GreyScript code to JavaScript:

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

3. GreyScript API Validation

Validate your code against the Grey Hack API:

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. Script Generation

Generate template scripts for common game tasks:

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

Available script types:

  • port_scanner: Network port scanning utility
  • password_cracker: Password cracking tool
  • file_browser: File browsing and manipulation utility
  • ssh_tool: SSH connection utility
  • custom: Custom script template (requires description)

Development

Building from Source

npm run build

Running in Development Mode

npm run dev

License

MIT

Acknowledgments

This project uses:

  • Model Context Protocol TypeScript SDK
  • Smithery GitHub Client
  • Axios for HTTP requests

Related Servers