READMEmain

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

Open Cursor settings (Cmd/Ctrl + ,)
Navigate to Features → MCP
Click "+ Add New MCP Server"
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

GreyHack Tools