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 請求