Grey Hack MCP 服务器

一个用于 Grey Hack 游戏开发的模型上下文协议 (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 token（用于代码搜索功能）

从 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. 输入以下详细信息：
   • Name: greyhack-mcp-server
   • Command: npx
   • Arguments: -y @smithery/cli@latest run @chromewillow/greyhack-mcp-server
   • Environment Variables: GITHUB_TOKEN=your-github-token-here

可用工具

1. GitHub 代码搜索

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

使用 search_greyhack_code 工具查找 Grey Hack 中端口扫描器的示例

2. Greybel-JS 转译

将 GreyScript 代码转换为 JavaScript：

使用 transpile_greyscript 工具将此 Grey Hack 代码转换为 JavaScript：
get_shell.host_computer.File("/home/user/test.txt")

3. GreyScript API 验证

根据 Grey Hack API 验证您的代码：

使用 validate_greyscript 工具检查此代码在 Grey Hack 0.8.0 中是否有效：
router = get_router
ip = router.local_ip

4. 脚本生成

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

使用 generate_greyhack_script 工具为 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
• Axios for HTTP requests