Hotkeyless Ahk Mcp

Hotkeyless AHK MCP とスキル

このリポジトリには、次のものが含まれています。

• Hotkeyless AHK HTTP API をラップする TypeScript 製 MCP サーバー。
• OpenCode、Claude、および汎用エージェントの実行環境向けの、再利用可能なスキルドキュメント。
• デスクトップ自動化の実用的なサンプル。

ワークスペースの構成

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

1. MCP サーバー

• クイックスタート
• Hotkeyless AHK API の仕様
• 設定

2. エージェントスキル

• クイックスタート

MCP サーバー

クイックスタート

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": ["*"]
    }
  },
  ...
}

ソースからビルドする

bun install
bun run build

{
  ...
  "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"
          ...
      }
    }
  },
  ...
}

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

{
  ...
  "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 の仕様

• GET /list は { command: string, note: string } の JSON 配列を返します。
• GET /send/<command> はクエリパラメーターを受け付けます。

設定

デフォルトの設定ファイルは mcp-server/dist/infrastructure/config/config.ts にあります。

環境変数による上書き：

エージェントスキル

クイックスタート

OpenCode

1. ./skills/.opencode/... フォルダーを次の場所にコピーします。

• プロジェクト固有のスキル設定の場合は .opencode/skills
• グローバル設定の場合は %USERPROFILE%/.config/opencode/skills

2. AGENTS.md、カスタムサブエージェント、またはカスタムコマンドを編集して、スキルを参照するようにできます。
3. OpenCode（CLI またはデスクトップ）を再起動します。
4. エージェントに「hotkeyless AHK skills」を使うように指示すると、スキルガイドを使用するようになります。

ClaudeCode

1. ./skills/.claude/... フォルダーを次の場所にコピーします。

• プロジェクト固有のスキル設定の場合は .claude/skills
• グローバル設定の場合は %USERPROFILE%/.config/claude-code/skills

2. CLAUDE.md、カスタムサブエージェント、またはカスタムコマンドを編集して、スキルを参照するようにできます。
3. Claude Code を再起動します。
4. エージェントに「hotkeyless AHK skills」を使うように指示すると、スキルガイドを使用するようになります。

Github Copilot

1. ./skills/.claude/... フォルダーを次の場所にコピーします。

• プロジェクト固有のスキル設定の場合は .claude/skills
• グローバル設定の場合は %USERPROFILE%/.config/claude-code/skills

2. AGENTS.md、カスタムサブエージェント、またはカスタムコマンドを編集して、スキルを参照するようにできます。
3. Claude Code を再起動します。
4. エージェントに「hotkeyless AHK skills」を使うように指示すると、スキルガイドを使用するようになります。

ライセンス

MIT