AutoHotkey v2 MCP サーバー

AutoHotkey v2 開発のための TypeScript MCP サーバーです。スクリプト解析、 ファイル操作、ドキュメント検索、スクリプト実行ツールを Claude Desktop などの MCP クライアントに提供します。

アーキテクチャ

Related MCP server: Hotkeyless AHK MCP

主な特長

• AutoHotkey ワークフローのための 25 以上の AHK_* ツール

• 対象を絞ったファイル検出とアクティブファイル対応の操作

• プロセストラッキングとウィンドウ検出を備えたスクリプト実行

• ローカル AutoHotkey 検証・診断ツール

• 組み込みの AutoHotkey ドキュメントとプロンプト/コンテキストヘルパー

• Stdio および Streamable HTTP トランスポート（ステートフルまたはステートレス）、さらにレガシー SSE エンドポイント

• HTTP モードでのオプトイン Bearer トークン認証と DNS リバインディング保護

必要条件

• Node.js 18+

• npm

• AutoHotkey v2（実行/検証ツール用）

インストール

git clone https://github.com/truecrimedev/ahk-mcp.git
cd ahk-mcp
npm install
npm run build

実行

npm start

開発モード:

npm run dev

スモークテスト:

npm run smoke:mcp

HTTP モードと環境変数

npm start は stdio（Claude Desktop）で通信します。Streamable HTTP を /mcp で公開するには（レガシー SSE エンドポイントも含む）、PORT を設定するか --sse を渡します:

npm run start:sse

動作は環境変数で制御します:

セキュリティ上の注意: ツールの機能にはファイル書き込みとプロセス実行が含まれます。HTTP ポートが自分のマシン以外から到達可能な場合は、AHK_MCP_AUTH_TOKEN（例: openssl rand -hex 32）と 2 つの許可リストを設定してください。デフォルトではエンドポイントはすべてのリクエストを受け入れます。

セッションフロー、ステートレスモードの詳細、cURL の例については docs/MCP_TRANSPORT_COMPATIBILITY.md を参照してください。

Claude Desktop の設定

claude_desktop_config.json にこれを追加します:

{
  "mcpServers": {
    "ahk": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\Users\\YourUsername\\path\\to\\ahk-mcp\\dist\\index.js"],
      "env": {
        "NODE_ENV": "production",
        "AHK_MCP_LOG_LEVEL": "warn"
      }
    }
  }
}

JSON では絶対パスを使用し、バックスラッシュをエスケープしてください。

AutoHotkey のパスと起動動作の設定

AHK_Config を使用して、実行可能ファイルのパスと非ブロッキング起動動作を設定します:

{
  "action": "set",
  "ahkPath": "C:\\Users\\YourUsername\\Documents\\Design\\Coding\\AutoHotkey\\bin\\AutoHotkey64.exe",
  "waitForStdoutLine": true,
  "stdoutLineTimeoutMs": 300
}

これは AHK_Run（および AHK_Cloud_Validate のパス解決）で使用されます。

コアツール

• AHK_Smart_Orchestrator: 複数ステップの編集・解析ワークフローを削減

• AHK_File_List、AHK_File_View、AHK_File_Edit: ファイル操作

• AHK_Analyze、AHK_Diagnostics: 解析と診断

• AHK_Run: スクリプトの実行（待機、非待機、ウィンドウ検出）

• AHK_Cloud_Validate: ローカル実行ベースの検証

• AHK_Doc_Search、AHK_Tools_Search: ドキュメントとツールの検索

• AHK_Config: MCP サーバーの設定

開発コマンド

npm run build
npm run clean
npm run lint
npm run test
npm run test:integration
npm run smoke:mcp

ドキュメント

• docs/README.md

• docs/QUICK_START.md

• docs/QUICKREFERENCE.md

• docs/MCP_TRANSPORT_COMPATIBILITY.md

• docs/ARCHITECTURE_DIAGRAMS.md

• docs/RELEASE_NOTES.md

コントリビューション

CONTRIBUTING.md と AGENTS.md を参照してください。

ライセンス

MIT。LICENSE を参照してください。