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 分