-
security-
license-
qualityA Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.
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
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-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:
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 utilitypassword_cracker: Password cracking toolfile_browser: File browsing and manipulation utilityssh_tool: SSH connection utilitycustom: 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
This server cannot be installed
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityA Model Context Protocol (MCP) server for Cursor IDE that simplifies the installation and configuration of other MCP servers.Last updated -39570MIT License
- -security-license-qualityA Model Context Protocol server that enables seamless integration between Cursor IDE and JIRA, allowing users to retrieve issues, execute JQL searches, and log work through natural language interactions.Last updated -
- Asecurity-licenseAqualityA Model Context Protocol server that integrates with Cursor IDE to provide real-time git-spice documentation search capability.Last updated -1141