Greyhack MCP Server

🚀 灰色黑客 MCP 服务器

本服务器是一个用于灰色游戏开发的模型上下文协议（MCP）服务器，可与 Cursor IDE 及其他兼容的 MCP 工具协同使用，为灰色游戏开发提供便利。

🚀 快速开始

本服务器专为灰色游戏开发设计，借助它，你可以在 GitHub 搜索代码、进行代码转译、验证 API 等。以下将详细介绍其安装和使用方法。

✨ 主要特性

• 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

可用工具

基础用法

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

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

• Greybel - JS 转译：将 GreyScript 代码转换为 JavaScript。

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

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

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

• 脚本生成：使用 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 请求