Hotkeyless AHK MCP およびスキル
👁 License: MIT
👁 AHK Version
👁 MCP
👁 Claude Support
👁 OpenCode Support
👁 Github Copilot Support
本リポジトリでは以下を提供します:
Hotkeyless AHK HTTP APIをラップするTypeScript MCPサーバー。
OpenCode、Claude、および汎用エージェントランタイム向けの再利用可能なスキルドキュメント。
デスクトップ自動化シナリオの実践的な例。
ワークスペースのレイアウト
packages/
mcp-server/ # Node MCP server package
skills/ # Agent skill documents
examples/ # End-to-end usage examplesRelated MCP server: ahk-mcp
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": ["*"]
}
},
...
}ソースからのビルド
1. サーバーのビルド
bun install
bun run buildnpmでも問題なく動作するはずです!
2. ハーネスのセットアップ
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コントラクト
GET /listは{ command: string, note: string }のJSON配列を返しますGET /send/<command>はクエリパラメータを受け付けます
設定
デフォルト設定は mcp-server/dist/infrastructure/config/config.ts にあります。
環境変数によるオーバーライド:
パラメータのオーバーライド | 説明 | デフォルト |
BASE_URL | Hotkeyless AHKサーバーのアドレス |
|
TIMEOUT_MS | 各リクエストのタイムアウト(ミリ秒) | 4000 |
BLACKLIST | 呼び出しを禁止するコマンドのリスト | [] |
CACHE_TTL_MS | コマンドリストのキャッシュ有効期間(ミリ秒) | 5000 |
ENDPOINT_LIST | コマンドリストのエンドポイントアドレス |
|
ENDPOINT_TRIGGER | コマンド呼び出し用のエンドポイントアドレス |
|
エージェントスキル
クイックスタート
OpenCode
./skills/.opencode/...フォルダを以下にコピーします
プロジェクト固有のスキル設定の場合は
.opencode/skillsグローバル設定の場合は
%USERPROFILE%/.config/opencode/skills
AGENTS.md、カスタムサブエージェント、またはカスタムコマンドを調整して、スキルを参照するように設定できます
OpenCode(CLIまたはデスクトップ)を再起動します
エージェントに「hotkeyless AHK skills」を使用するように指示すると、スキルガイドが使用されるはずです
ClaudeCode
./skills/.claude/...フォルダを以下にコピーします
プロジェクト固有のスキル設定の場合は
.claude/skillsグローバル設定の場合は
%USERPROFILE%/.config/claude-code/skills
CLAUDE.md、カスタムサブエージェント、またはカスタムコマンドを調整して、スキルを参照するように設定できます
Claude Codeを再起動します
エージェントに「hotkeyless AHK skills」を使用するように指示すると、スキルガイドが使用されるはずです
Github Copilot
./skills/.claude/...フォルダを以下にコピーします
プロジェクト固有のスキル設定の場合は
.claude/skillsグローバル設定の場合は
%USERPROFILE%/.config/claude-code/skills
AGENTS.md、カスタムサブエージェント、またはカスタムコマンドを調整して、スキルを参照するように設定できます
Claude Codeを再起動します
エージェントに「hotkeyless AHK skills」を使用するように指示すると、スキルガイドが使用されるはずです
ライセンス
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/tim0-12432/HotkeylessAHK-mcp-skill'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
