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-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

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that enhances Grey Hack game development by providing GitHub code search, GreyScript validation, script generation, and Greybel-JS transpilation capabilities when used with Cursor IDE.

Related MCP Servers

MCP JavaScript Server
davlgd
-
security
A
license
-
quality
An unofficial JavaScript SDK to create customized servers for the Model Context Protocol, allowing definition of prompts, resources, and tools for tailored interactions.
Last updated -
6
2
JavaScript
Apache 2.0
Unity MCP Server
GrandMasterK414
-
security
F
license
-
quality
A Model Context Protocol server for Unity game development that enables users to manage projects, edit scenes, create prefabs, and generate scripts through natural language integration with Smithery.ai.
Last updated -
TypeScript
Figma MCP Server
1yhy
-
security
A
license
-
quality
A Model Context Protocol server that integrates Figma design files with AI coding tools like Cursor, Windsurf, and Cline, allowing AI tools to access and understand Figma design data for generating more accurate code.
Last updated -
124
6
TypeScript
MIT License
DeepView MCP
ai-1st
-
security
A
license
-
quality
A Model Context Protocol server that enables IDEs like Cursor and Windsurf to analyze large codebases using Gemini's extensive context window.
Last updated -
17
Python
MIT License

View all related MCP servers

Appeared in Searches

How to update software

Grey Hack MCP Server