AutoHotkey v2 MCP Server

TypeScript MCP-сервер для разработки на AutoHotkey v2. Он предоставляет инструменты анализа скриптов, работы с файлами, поиска по документации и выполнения скриптов для MCP-клиентов, таких как Claude Desktop.

Архитектура

Related MCP server: Hotkeyless AHK MCP

Возможности

• 25+ инструментов AHK_* для рабочих процессов AutoHotkey

• Целевой поиск файлов и операции с учётом активного файла

• Выполнение скриптов с отслеживанием процессов и обнаружением окон

• Локальные инструменты проверки и диагностики AutoHotkey

• Встроенная документация AutoHotkey и помощники по подсказкам/контексту

• Транспорты Stdio и Streamable HTTP (с сохранением состояния или без), а также устаревшие конечные точки SSE

• Опциональная аутентификация по bearer-токену и защита от DNS-rebinding в HTTP-режиме

Требования

• 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) и оба разрешённых списка — по умолчанию конечные точки принимают любой запрос.

См. docs/MCP_TRANSPORT_COMPATIBILITY.md о потоке сеансов, деталях режима без состояния и примерах cURL.

Конфигурация 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.