Grey Hack MCP Server

What is Grey Hack MCP Server?

A Model Context Protocol (MCP) server for Grey Hack game development. It integrates with Cursor IDE and other MCP-compatible tools to search GitHub code, transpile GreyScript to JavaScript, validate code against the Grey Hack API, and generate script templates.

How to use Grey Hack MCP Server?

Install from npm with npm install -g @chromewillow/greyhack-mcp-server or clone the repository and run npm install && npm run build. Configure it in Cursor IDE via .cursor/mcp.json or manually in Cursor settings (Features → MCP) with the command npx -y @smithery/cli@latest run @chromewillow/greyhack-mcp-server and a GITHUB_TOKEN environment variable.

Key features of Grey Hack MCP Server

• Search Grey Hack code examples on GitHub
• Transpile GreyScript code to JavaScript
• Validate code against the official Grey Hack API
• Generate script templates (port scanner, password cracker, etc.)

Use cases of Grey Hack MCP Server

• Find existing Grey Hack scripts and examples on GitHub
• Convert GreyScript to JavaScript for analysis or reuse
• Check code compatibility with a specific Grey Hack version
• Quickly scaffold common game utilities without writing from scratch

FAQ from Grey Hack MCP Server

What are the prerequisites?

Node.js 18+ and an MCP-compatible editor (e.g., Cursor IDE). A GitHub API token is required for the code search functionality.

How do I install Grey Hack MCP Server?

Install globally via npm: npm install -g @chromewillow/greyhack-mcp-server. Alternatively, clone the repository, install dependencies with npm install, and build with npm run build.

What tools does it provide?

Four tools: search_greyhack_code (GitHub search), transpile_greyscript (Greybel-JS transpilation), validate_greyscript (API validation), and generate_greyhack_script (script generation with types like port_scanner, password_cracker, file_browser, ssh_tool, custom).

Do I need a GitHub API token?

Yes, the server expects a GITHUB_TOKEN environment variable for the GitHub code search tool.

What Grey Hack version does it target?

Examples in the README reference Grey Hack 0.8.0. The validation tool checks code against the official Grey Hack API for that version.