Greyhack MCP Server

🚀 Grey Hack MCP Server

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

🚀 Quick Start

The Grey Hack MCP Server is a powerful tool for Grey Hack game development. It offers a range of features to assist developers, including code search, code translation, API validation, and script generation.

✨ Features

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

📦 Installation

Prerequisites

• Node.js version 18+ installed.
• Cursor IDE or other compatible MCP editors installed.
• GitHub API token (required for the code search feature).

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 Examples

Using with Cursor IDE

Using a 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 information:
   • 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

Use the search_greyhack_code tool to find Grey Hack game code examples on GitHub:

Use the search_greyhack_code tool to search for Grey Hack game code examples of a port scanner on GitHub.

2. Greybel-JS Transpilation

Convert GreyScript code to JavaScript:

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

3. GreyScript API Validation

Verify if your code complies with the Grey Hack game API:

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

4. Script Generation

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

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

Available script types:

• port_scanner: A network port scanning utility.
• password_cracker: A password cracking tool.
• file_browser: A file browsing and manipulation utility.
• ssh_tool: An SSH connection utility.
• custom: Custom script templates (require a description).

🔧 Technical Details

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