Grey Hack MCP Server

Grey Hack MCP サーバー

Grey Hack のゲーム開発向けに設計された Model Context Protocol（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 トークン（コード検索機能用）

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 のコード例を検索します。

Use the search_greyhack_code tool to find examples of port scanners in Grey Hack

2. Greybel-JS トランスパイル

GreyScript コードを JavaScript に変換します。

Use the transpile_greyscript tool to convert this Grey Hack code to JavaScript:
get_shell.host_computer.File("/home/user/test.txt")

3. GreyScript API 検証

Grey Hack API に照らしてコードを検証します。

Use the validate_greyscript tool to check if this code is valid in Grey Hack 0.8.0:
router = get_router
ip = router.local_ip

4. スクリプト生成

ゲームでよく使われるタスク向けのテンプレートスクリプトを生成します。

Use the generate_greyhack_script tool to create a port scanner for 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
• HTTP リクエスト用の Axios