Grey Hack MCP Server

Grey Hack MCP 服务

一个用于 Grey Hack 游戏开发的 Model Context Protocol（MCP）服务，旨在与 Cursor IDE 和其他兼容 MCP 的工具配合使用。

功能

• GitHub 代码搜索：从 GitHub 仓库中查找 Grey Hack 代码示例
• Greybel-JS 转译：将 GreyScript 转换为 JavaScript
• GreyScript API 验证：根据官方 Grey Hack API 验证代码
• 脚本生成：为常见游戏任务生成模板脚本

安装

先决条件

• 已安装 Node.js 18+
• Cursor IDE 或其他兼容 MCP 的编辑器
• GitHub API 令牌（用于代码搜索功能）

从 NPM 安装

npm install -g @chromewillow/greyhack-mcp-server

手动安装

克隆仓库并安装依赖项：

git clone https://github.com/chromewillow/greyhack-mcp-server.git
cd greyhack-mcp-server
npm install
npm run build

在 Cursor IDE 中使用

使用配置文件

在工作区中创建 .cursor/mcp.json 文件，内容如下：

{
  "mcpServers": {
    "@greyhack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@chromewillow/greyhack-mcp-server",
        "--config",
        "{\"GITHUB_TOKEN\":\"your-github-token-here\"}"
      ]
    }
  }
}

在 Cursor 中手动配置

1. 打开 Cursor 设置（Cmd/Ctrl + ,）
2. 导航到 Features → MCP
3. 点击“+ Add New MCP Server”
4. 输入以下详细信息：
   • 名称：greyhack-mcp-server
   • 命令：npx
   • 参数：-y @smithery/cli@latest run @chromewillow/greyhack-mcp-server
   • 环境变量：GITHUB_TOKEN=your-github-token-here

可用工具

1. GitHub 代码搜索

在 GitHub 上搜索 Grey Hack 代码示例：

Use the search_greyhack_code tool to find examples of port scanners in Grey Hack

2. Greybel-JS 转译

将 GreyScript 代码转换为 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 验证

根据 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. 脚本生成

为常见游戏任务生成模板脚本：

Use the generate_greyhack_script tool to create a port scanner for Grey Hack 0.8.0

可用脚本类型：

• port_scanner：网络端口扫描工具
• password_cracker：密码破解工具
• file_browser：文件浏览和操作工具
• ssh_tool：SSH 连接工具
• custom：自定义脚本模板（需要提供描述）

开发

从源代码构建

npm run build

在开发模式下运行

npm run dev

许可证

MIT

致谢

本项目使用了：

• Model Context Protocol TypeScript SDK
• Smithery GitHub Client
• 用于 HTTP 请求的 Axios