Provides GitHub code search functionality to find Grey Hack code examples from GitHub repositories
Enables transpilation of GreyScript code to JavaScript through the Greybel-JS transpilation tool
Requires Node.js 18+ for server operation and provides integration with the Grey Hack game development environment
Allows installation of the MCP server via NPM package registry
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
Related MCP server: Cursor MCP Installer
Installation
Prerequisites
Node.js 18+ installed
Cursor IDE or another MCP-compatible editor
GitHub API token (for code search functionality)
Install from NPM
Manual Installation
Clone the repository and install dependencies:
Usage with Cursor IDE
Using Configuration File
Create a .cursor/mcp.json file in your workspace with the following content:
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-serverCommand:
npxArguments:
-y @smithery/cli@latest run @chromewillow/greyhack-mcp-serverEnvironment Variables:
GITHUB_TOKEN=your-github-token-here
Available Tools
1. GitHub Code Search
Search for Grey Hack code examples on GitHub:
2. Greybel-JS Transpilation
Convert GreyScript code to JavaScript:
3. GreyScript API Validation
Validate your code against the Grey Hack API:
4. Script Generation
Generate template scripts for common game tasks:
Available script types:
port_scanner: Network port scanning utilitypassword_cracker: Password cracking toolfile_browser: File browsing and manipulation utilityssh_tool: SSH connection utilitycustom: Custom script template (requires description)
Development
Building from Source
Running in Development Mode
License
MIT
Acknowledgments
This project uses:
Model Context Protocol TypeScript SDK
Smithery GitHub Client
Axios for HTTP requests