HotkeylessAHK Mcp Skill

io.github.tim0-12432由 GitHub 帳號 tim0-12432 發布v1.0.8更新於 Oct 24, 2026

MCP server for Hotkeyless AHK HTTP API.

已驗證STDIO僅桌面效率與工作流開發者工具

概覽

AI 產生的概覽

一個本機 MCP 伺服器，包裝 Hotkeyless AHK HTTP API，讓助理在 Windows 桌面上列出並觸發 AutoHotkey 指令。

可以做什麼
從指令清單端點讀取可用的 Hotkeyless AHK 指令及其說明，並依可設定的快取有效期快取（GET /list）。
適用情境
當你已有 Hotkeyless AHK 環境，希望助理透過指令名稱觸發 AutoHotkey 動作、而不必手動按快速鍵時使用。
執行需求
以本機 Node.js 程序執行，可透過 npx 從 npm 套件啟動，也可從原始碼建置。需要一個可連線的 Hotkeyless AHK HTTP 伺服器，預設位址為 BASE_URL 設定。選用環境變數：TIMEOUT_MS、BLACKLIST、CACHE_TTL_MS、ENDPOINT_LIST、ENDPOINT_TRIGGER。僅限桌面端；未宣告身分驗證。
安裝前請注意
觸發指令會操作使用者桌面，可能執行已註冊的任意 AutoHotkey 腳本，效果往往難以復原。請用 BLACKLIST 封鎖 shutdown、restart、kill 等危險指令。請求會送往設定的 BASE_URL，預設為本機位址，只應指向可信任的伺服器。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 HotkeylessAHK Mcp Skill，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Hotkeyless AHK MCP and Skills

[License: MIT] [AHK Version] [MCP] [Claude Support] [OpenCode Support] [Github Copilot Support]

This repository provides:

  • A TypeScript MCP server that wraps the Hotkeyless AHK HTTP API.
  • Reusable skill documents for OpenCode, Claude, and generic agent runtimes.
  • Practical examples for desktop automation scenarios.

Workspace layout

text
packages/  mcp-server/   # Node MCP server package  skills/       # Agent skill documentsexamples/       # End-to-end usage examples
  1. MCP server
  1. Agent skills

MCP server

Quick start

OpenCode

opencode.json:

json
{  ...  "mcp": {    ...    "hotkeyless-ahk": {      "type": "local",      "command": ["npx", "-y", "@tim0_12432/hotkeyless-ahk-mcp-server"],      "enabled": true,      "environment": {          "BLACKLIST": "shutdown,restart,kill"          ...      }    }  },  ...}
ClaudeCode

.mcp.json:

json
{  "mcpServers": {    ...    "hotkeyless-ahk": {      "command": "npx",      "args": ["-y", "@tim0_12432/hotkeyless-ahk-mcp-server"],      "env": {        "BLACKLIST": "shutdown,restart,kill"        ...      }    }  }}
Github Copilot

mcp-config.json:

json
{  ...  "mcpServers": {    ...    "hotkeyless-ahk": {      "type": "local",      "command": "npx",      "args": ["-y", "@tim0_12432/hotkeyless-ahk-mcp-server"],      "env": {        "BLACKLIST": "shutdown,restart,kill"          ...      },      "tools": ["*"]    }  },  ...}

Build from source

Follow instructions here.
1. Build server
bash
bun installbun run build

npm should also work without problems!

2. Setup your harness
OpenCode

opencode.json:

json
{  ...  "mcp": {    ...    "hotkeyless-ahk": {      "type": "local",      "command": ["node", "<absolute path to the built files>/mcp-server/dist/index.js"],      "enabled": true,      "environment": {          "BLACKLIST": "shutdown,restart,kill"          ...      }    }  },  ...}
ClaudeCode

.mcp.json:

json
{  "mcpServers": {    ...    "hotkeyless-ahk": {      "command": "node",      "args": ["<absolute path to the built files>/mcp-server/dist/index.js"],      "env": {        "BLACKLIST": "shutdown,restart,kill"        ...      }    }  }}
Github Copilot

mcp-config.json:

json
{  ...  "mcpServers": {    ...    "hotkeyless-ahk": {      "type": "local",      "command": "node",      "args": ["<absolute path to the built files>/mcp-server/dist/index.js"],      "env": {        "BLACKLIST": "shutdown,restart,kill"          ...      },      "tools": ["*"]    }  },  ...}

Hotkeyless AHK API contract

  • GET /list returns JSON array of { command: string, note: string }
  • GET /send/<command> accepts query parameters

Configuration

Default config is at mcp-server/dist/infrastructure/config/config.ts.

Environment overrides:

Parameter overrideWhat it doesDefault
BASE_URLAdress of the Hotkeyless AHK serverhttp://localhost:42800
TIMEOUT_MSTimeout milliseconds for each request4000
BLACKLISTA list of commands to avoid being called[]
CACHE_TTL_MSCache lifetime for command list in milliseconds5000
ENDPOINT_LISTEndpoint address of the command list/list
ENDPOINT_TRIGGEREndpoint address for invoking commands/send

Agent Skills

Quick start

OpenCode
  1. Copy the ./skills/.opencode/... folders to
  • .opencode/skills for project specific skill setup
  • %USERPROFILE%/.config/opencode/skills for global setup
  1. You can adjust AGENTS.md, custom subagents or custom commands to reference the skills
  2. Restart your OpenCode (CLI or Desktop)
  3. When asking the agent to use the "hotkeyless AHK skills" it should now use the skill guide
ClaudeCode
  1. Copy the ./skills/.claude/... folders to
  • .claude/skills for project specific skill setup
  • %USERPROFILE%/.config/claude-code/skills for global setup
  1. You can adjust CLAUDE.md, custom subagents or custom commands to reference the skills
  2. Restart your Claude Code
  3. When asking the agent to use the "hotkeyless AHK skills" it should now use the skill guide
Github Copilot
  1. Copy the ./skills/.claude/... folders to
  • .claude/skills for project specific skill setup
  • %USERPROFILE%/.config/claude-code/skills for global setup
  1. You can adjust AGENTS.md, custom subagents or custom commands to reference the skills
  2. Restart your Claude Code
  3. When asking the agent to use the "hotkeyless AHK skills" it should now use the skill guide

License

MIT

來源：README.md，提交 97afad0

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.8最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分