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

How are these scores calculated?

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 Server for Cursor
AntDX316
-
security
F
license
-
quality
A Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.
Last updated -
673
1
Python
Cursor MCP Installer
matthewdcage
A
security
A
license
A
quality
A Model Context Protocol (MCP) server for Cursor IDE that simplifies the installation and configuration of other MCP servers.
Last updated -
3
131
65
JavaScript
MIT License
JIRA MCP Server
klauseduard
-
security
F
license
-
quality
A 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 -
Python
Git Spice Help MCP Server
sach999
A
security
F
license
A
quality
A Model Context Protocol server that integrates with Cursor IDE to provide real-time git-spice documentation search capability.
Last updated -
1
430
1
TypeScript

View all related MCP servers

Appeared in Searches

How to update software

Grey Hack MCP Server