Greyhack MCP Server

🚀 灰色黑客 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 トランスパイル

transpile_greyscript ツールを使用して、GreyScript コードを JavaScript に変換します。

transpile_greyscript ツールを使用して、以下の灰色ゲームコードを JavaScript に変換します。
get_shell.host_computer.File("/home/user/test.txt")

3. GreyScript API 検証

validate_greyscript ツールを使用して、コードが灰色ゲーム 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 リクエスト用）