English Français العربية

io.github.tim0-12432/HotkeylessAHK-mcp-skill

السجل الرسمي أخرى

MCP server for Hotkeyless AHK HTTP API.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @tim0_12432/hotkeyless-ahk-mcp-server
Claude Code 
claude mcp add hotkeylessahk-mcp-skill -e 'BASE_URL=<BASE_URL>' -e 'TIMEOUT_MS=<TIMEOUT_MS>' -e 'BLACKLIST=<BLACKLIST>' -e 'CACHE_TTL_MS=<CACHE_TTL_MS>' -e 'ENDPOINT_LIST=<ENDPOINT_LIST>' -e 'ENDPOINT_TRIGGER=<ENDPOINT_TRIGGER>' -- npx -y @tim0_12432/hotkeyless-ahk-mcp-server@1.0.8
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "hotkeylessahk-mcp-skill": {
            "command": "npx",
            "args": [
                "-y",
                "@tim0_12432/hotkeyless-ahk-mcp-server@1.0.8"
            ],
            "env": {
                "BASE_URL": "<BASE_URL>",
                "TIMEOUT_MS": "<TIMEOUT_MS>",
                "BLACKLIST": "<BLACKLIST>",
                "CACHE_TTL_MS": "<CACHE_TTL_MS>",
                "ENDPOINT_LIST": "<ENDPOINT_LIST>",
                "ENDPOINT_TRIGGER": "<ENDPOINT_TRIGGER>"
            }
        }
    }
}

متغيرات البيئة

  • BASE_URL The base URL of the Hotkeyless AHK HTTP server.
  • TIMEOUT_MS The timeout in milliseconds for requests to the server.
  • BLACKLIST A comma-separated list of blacklisted commands.
  • CACHE_TTL_MS The time-to-live in milliseconds for cached responses.
  • ENDPOINT_LIST The default endpoint path for listing commands.
  • ENDPOINT_TRIGGER The default endpoint path for triggering commands.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Hotkeyless AHK MCP and Skills
  2. Workspace layout
  3. MCP server
  4. Agent Skills
  5. License

Hotkeyless AHK MCP and Skills

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

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

MCP server

Quick start
OpenCode

opencode.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:

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

mcp-config.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
bun install
bun run build

npm should also work without problems!

2. Setup your harness
OpenCode

opencode.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:

{
  "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:

{
  ...
  "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
  2. You can adjust AGENTS.md, custom subagents or custom commands to reference the skills
  3. Restart your OpenCode (CLI or Desktop)
  4. 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
  2. You can adjust CLAUDE.md, custom subagents or custom commands to reference the skills
  3. Restart your Claude Code
  4. 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
  2. You can adjust AGENTS.md, custom subagents or custom commands to reference the skills
  3. Restart your Claude Code
  4. When asking the agent to use the "hotkeyless AHK skills" it should now use the skill guide

License

MIT

الأسئلة الشائعة

ما هو io.github.tim0-12432/HotkeylessAHK-mcp-skill؟

MCP server for Hotkeyless AHK HTTP API.

كيف أثبّت io.github.tim0-12432/HotkeylessAHK-mcp-skill؟

يعمل على جهازك. في Claude Code: claude mcp add hotkeylessahk-mcp-skill -e 'BASE_URL=<BASE_URL>' -e 'TIMEOUT_MS=<TIMEOUT_MS>' -e 'BLACKLIST=<BLACKLIST>' -e 'CACHE_TTL_MS=<CACHE_TTL_MS>' -e 'ENDPOINT_LIST=<ENDPOINT_LIST>' -e 'ENDPOINT_TRIGGER=<ENDPOINT_TRIGGER>' -- npx -y @tim0_12432/hotkeyless-ahk-mcp-server@1.0.8. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.tim0-12432/HotkeylessAHK-mcp-skill إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.tim0-12432/HotkeylessAHK-mcp-skill مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.tim0-12432/HotkeylessAHK-mcp-skill؟

ينشره tim0-12432. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.