Hotkeyless Ahk Mcp

@tim0-12432

Hotkeyless Ahk Mcp について

MCP server for Hotkeyless AHK HTTP API. It lets your agent control your whole computer through hotkeys.

#ahk #hotkeyless-ahk #hotkeys #auto-hotkey

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Hotkeyless Ahk Mcp?

Hotkeyless Ahk Mcp is a TypeScript MCP server that wraps the Hotkeyless AHK HTTP API, enabling AI agents to invoke AutoHotkey commands without needing keyboard shortcuts. It includes reusable skill documents for OpenCode, Claude Code, and GitHub Copilot, designed for desktop automation tasks.

How to use Hotkeyless Ahk Mcp?

Install and run via npx -y @tim0_12432/hotkeyless-ahk-mcp-server or build from source with bun install && bun run build. Configure the server in opencode.json, .mcp.json, or mcp-config.json with environment variables like BLACKLIST, BASE_URL, and TIMEOUT_MS. For skill documents, copy skill folders into the appropriate .opencode/skills, .claude/skills, or .github/copilot/skills directories.

Key features of Hotkeyless Ahk Mcp

Wraps the Hotkeyless AHK HTTP API as an MCP server
Configurable blacklist, timeout, cache, and server address
Supports OpenCode, Claude Code, and GitHub Copilot
Includes ready-to-use skill documents for agent runtimes
Can be run via npx or built from source

Use cases of Hotkeyless Ahk Mcp

Automate Windows desktop tasks via AI agent prompts
Execute AHK scripts without manual keyboard shortcuts
Integrate AHK commands into Claude Code or GitHub Copilot workflows
Build agent-driven UI automation and file management routines

FAQ from Hotkeyless Ahk Mcp

What runtime dependencies does Hotkeyless Ahk Mcp require?

It requires Node.js (to run npx or the built server) and a running instance of Hotkeyless AHK (listening on http://localhost:42800 by default).

How can I restrict which commands the server may invoke?

Set the BLACKLIST environment variable to a comma‑separated list of commands to block, for example "shutdown,restart,kill".

Does the server cache the list of available commands?

Yes, by default the command list is cached for 5000 ms. The cache time can be changed via the CACHE_TTL_MS environment variable.

What transport protocol does Hotkeyless Ahk Mcp use?

The MCP server runs as a local process using the standard input/output transport (stdio) for communicating with the MCP client.

Where does the server store or access user data?

The server does not store data itself; it only forwards commands to the Hotkeyless AHK HTTP API running on the local machine. All command execution happens on the user's system.

よくある質問