What is Greyhack Mcp Server

The greyhack-mcp-server is a Model Context Protocol (MCP) server designed for Grey Hack game development, compatible with Cursor IDE and other MCP-compatible tools.

Use cases

Use cases for greyhack-mcp-server include searching for code examples, converting scripts, validating code against the Grey Hack API, and generating templates for tasks like port scanning and password cracking.

How to use

To use greyhack-mcp-server, install it via NPM or manually clone the repository. Configure it in Cursor IDE by creating a .cursor/mcp.json file or through the manual settings interface, providing your GitHub API token for code search functionality.

Key features

Key features include GitHub Code Search for finding Grey Hack examples, Greybel-JS Transpilation to convert GreyScript to JavaScript, GreyScript API Validation to check code validity, and Script Generation for common game tasks.

Where to use

greyhack-mcp-server is primarily used in game development, specifically for creating and managing scripts in the Grey Hack game environment.

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