关于 ahk-mcp
ahk-mcp 是一个 MCP 服务，将 AutoHotkey 的功能以工具形式暴露给 AI 模型，用于 Windows 上的自动化任务。它面向需要操作桌面应用的 AI 助手，并提供屏幕 OCR 作为补充。
主要功能
- 01枚举窗口与应用程序
- 02控制键盘与鼠标输入
- 03通过 Windows API 读取窗口文本与控件位置
- 04屏幕截图与 OCR 识别
- 05查询显示器与窗口位置信息
适用场景
- 01让 AI 助手读取无法通过常规接口获取的窗口文本
- 02自动化在 Windows 应用中的点击与输入操作
- 03根据多显示器布局定位并管理窗口
MCP 相关
该项目是一个 MCP 服务，向 MCP 客户端暴露 33 个工具，覆盖窗口、输入设备、屏幕截图和 OCR 等操作。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。
详细介绍
ahk-mcp
提供 AutoHotkey 功能的 MCP 服务，让模型能够在 Windows 上执行自动化任务。
此服务仅适用于 Windows，并为 AI 提供以下工具：
- 枚举窗口和应用程序
- 控制键盘和鼠标（输入文字、点击等）
- 通过 AutoHotkey 查询 Windows API，获取窗口信息（例如窗口文本、GUI 控件的位置等）
- 屏幕截图和 OCR 功能（当 Windows API/控件无法正确提供文本时很有用）
- 获取准确的窗口位置以及有关电脑显示器的上下文信息（例如了解主显示器和副显示器上有哪些窗口）
- 通过 AutoHotkey 操作窗口及执行其他操作
此服务目前共提供 33 个工具，以上只是简单概述。
在我们编写文档期间，欢迎查看 main.py 中的源代码！
Usage
本项目使用基于 FastMCP 的 Python MCP SDK。有关详细信息，请参阅 Python MCP SDK 仓库和文档。
假设你已设置好 mcp CLI，只需运行一条简单的 mcp 命令，即可在 Claude Desktop 中安装此 MCP 服务：
mcp install main.py
本项目依赖 ahk-binary 来提供所需的 AutoHotkey 可执行文件，并使用 ahk 项目与 AutoHotkey 交互。OCR 功能使用 mss、easyocr 和 numpy。
Contributing
在 GitHub 上直接参与是最佳的贡献方式。欢迎提交 issue 开始参与。我们也欢迎拉取请求，但强烈建议先提交 issue，尤其是涉及重大更改时。
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。