灰色黑客 MCP 服务器

一个用于灰色游戏开发的模型上下文协议（MCP）服务器，设计用于与 Cursor IDE 和其他兼容的 MCP 工具一起使用。

功能

• GitHub 代码搜索：从 GitHub 仓库中查找灰色游戏代码示例
• Greybel-JS 转译：将 GreyScript 转换为 JavaScript
• GreyScript API 验证：验证代码是否符合官方灰色游戏 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. 导航到功能 → MCP
3. 点击 "+ 添加新的 MCP 服务器"
4. 输入以下信息：
   • 名称：greyhack-mcp-server
   • 命令：npx
   • 参数：-y @smithery/cli@latest run @chromewillow/greyhack-mcp-server
   • 环境变量：GITHUB_TOKEN=your-github-token-here

可用工具

1. GitHub 代码搜索

使用 search_greyhack_code 工具在 GitHub 上查找灰色游戏代码示例：

使用 search_greyhack_code 工具在 GitHub 上搜索端口扫描器的灰色游戏代码示例

2. Greybel-JS 转译

将 GreyScript 代码转换为 JavaScript：

使用 transpile_greyscript 工具将以下灰色游戏代码转换为 JavaScript：
get_shell.host_computer.File("/home/user/test.txt")

3. GreyScript API 验证

验证您的代码是否符合灰色游戏 API：

使用 validate_greyscript 工具检查以下代码在灰色游戏 0.8.0 中是否有效：
router = get_router
ip = router.local_ip

4. 脚本生成

使用 generate_greyhack_script 工具创建一个端口扫描器，用于灰色游戏 0.8.0：

使用 generate_greyhack_script 工具为灰色游戏 0.8.0 创建一个端口扫描器

可用脚本类型：

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

开发

从源代码构建

npm run build

在开发模式下运行

npm run dev

许可证

MIT

致谢

此项目使用：

• 模型上下文协议 TypeScript SDK
• Smithery GitHub 客户端
• Axios 进行 HTTP 请求