Greyhack MCP Server

🚀 灰色黑客 MCP 服务器

灰色黑客 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 请求