https://github.com/spyoungtech/ahk-mcp
MCP server exposing AutoHotkey functionality, enabling model interfaces to automation tasks on Windows.
https://github.com/spyoungtech/ahk-mcp
ai autohotkey automation mcp ocr
Last synced: 2 months ago
JSON representation
MCP server exposing AutoHotkey functionality, enabling model interfaces to automation tasks on Windows.
- Host: GitHub
- URL: https://github.com/spyoungtech/ahk-mcp
- Owner: spyoungtech
- Created: 2025-04-03T00:23:35.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-21T03:36:03.000Z (about 1 year ago)
- Last Synced: 2025-05-21T04:32:05.990Z (about 1 year ago)
- Topics: ai, autohotkey, automation, mcp, ocr
- Language: Python
- Homepage:
- Size: 32.2 KB
- Stars: 4
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ahk-mcp
MCP server exposing AutoHotkey functionality, enabling model interfaces to automation tasks on Windows.
This server only works on Windows and provides the following tools to your AI:
- Ability to enumerate windows/applications
- Ability to control keyboard/mouse (typing, clicking, etc)
- Ability to interrogate Windows APIs (via AutoHotkey) about windows (e.g., to get the text of a window, the position of its GUI controls, etc.)
- Screen capture & OCR functionality (useful when text is not exposed properly by Windows APIs/controls)
- Ability to get accurate window positioning and contextual information about computer monitors (e.g., know what windows are on your primary/secondary monitors)
- Ability to manipulate windows and other actions via AutoHotkey
In total, there are 33 tools currently exposed by the server, the above is just a simple overview.
While we work on documentation, exploring the source code in `main.py` is encouraged!
## Usage
This project makes use of the [Python MCP SDK](https://github.com/modelcontextprotocol/python-sdk) with FastMCP. Please
see the Python MCP SDK repo and documentation for detailed information.
Assuming you've already setup `mcp` CLI, you can install this MCP service in Claude Desktop with a simple `mcp` command:
```bash
mcp install main.py
```
This project depends on `ahk-binary` to provide the required AutoHotkey executables and the [`ahk`](https://github.com/spyoungtech/ahk)
project to interface with AutoHotkey. It uses `mss`, [`easyocr`](https://github.com/JaidedAI/EasyOCR?tab=readme-ov-file#installation), and `numpy`
for OCR functionality.
## Contributing
The best way to contribute is right here on GitHub. Please feel free to [open an issue](https://github.com/spyoungtech/ahk-mcp/issues)
to get started. Pull requests are also welcome, but it is strongly recommended to open an issue first, especially for
significant changes.