项目简介

AutoHotkey MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端应用，旨在增强大型语言模型（LLM），如 Claude AI，处理和理解 AutoHotkey (AHK) 脚本代码的能力。它通过标准化的 MCP 协议，为 LLM 客户端提供一系列工具，使其能够更有效地分析、理解和生成 AutoHotkey 代码。

主要功能点

代码分析工具 (analyze_code): 检测 AutoHotkey 代码中的潜在问题，并提供改进建议，帮助用户提升代码质量。
变量查找工具 (find_variables): 根据用户提供的提示，查找并返回相关的 AutoHotkey 内置变量信息，方便用户快速了解和使用变量。
函数信息查询工具 (get_function_info): 提供 AutoHotkey 函数的详细信息，支持精确函数名查找和关键词搜索，帮助用户掌握函数用法。
类信息查询工具 (get_class_info): 支持 AutoHotkey 类和方法的查询，允许用户通过类名、方法名或关键词搜索，获取类和方法的详细信息。

安装步骤

克隆仓库: 首先，将 ahk-mcp 仓库克隆到本地。
安装依赖: 确保你的系统已安装 Node.js 和 npm。在仓库根目录下，运行 'npm install' 命令安装项目依赖。
构建服务器: 运行 'npm run build' 命令编译 TypeScript 代码并复制必要的数据文件到 'dist' 目录。

服务器配置

为了让 MCP 客户端（例如 Claude）连接到此服务器，你需要配置客户端的 MCP 设置文件。以下是一个配置示例，你需要根据你的实际情况进行调整。请注意，以下是配置信息，并非启动命令，请勿在命令行中直接运行。

{
  "mcpServers": {
    "ahk-server": {
      "autoApprove": [
        "analyze_code",
        "find_variables",
        "get_function_info",
        "get_class_info"
      ],
      "disabled": false,
      "timeout": 60,
      "command": "node",  // 启动服务器的命令，这里使用 Node.js 运行
      "args": [
        "服务器 index.js 文件的绝对路径"  //  index.js 文件的路径，需要替换为实际路径。例如 "C:\\Users\\USERNAME\\OneDrive\\Documents\\Cline\\MCP\\ahk-server\\dist\\index.js"
      ],
      "transportType": "stdio" //  指定使用 Stdio 传输协议
    }
  }
}

配置参数说明:

'"server name"': '"ahk-server"' - 服务器名称，可以自定义。
'"command"': '"node"' - 启动服务器的命令，通常为 'node'。
'"args"': '["服务器 index.js 文件的绝对路径"]' - 启动命令的参数，最重要的是 index.js 文件的绝对路径。你需要将 '"服务器 index.js 文件的绝对路径"' 替换为你本地 'dist/index.js' 文件的实际绝对路径。
'"transportType"': '"stdio"' - 指定 MCP 客户端与服务器之间使用 Stdio 标准输入输出流进行通信。
'"autoApprove"': '["analyze_code", "find_variables", "get_function_info", "get_class_info"]' - 自动批准的工具列表，客户端调用这些工具时无需用户手动批准。
'"disabled"': 'false' - 服务器是否禁用，'false' 表示启用。
'"timeout"': '60' - 请求超时时间，单位为秒。

配置文件路径 (根据 Claude 客户端类型选择):

Claude 桌面应用: '~/Library/Application Support/Claude/claude_desktop_config.json' (macOS) 或 '~/AppData/Roaming/Claude/claude_desktop_config.json' (Windows)
Claude VS Code 扩展: '%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json' (Windows)

基本使用方法

启动服务器: 在仓库根目录下，运行 'npm start' 或双击 'start-mcp-server.bat' 启动服务器。
配置 Claude 客户端: 根据上述 服务器配置 步骤，配置 Claude 桌面应用或 VS Code 扩展，指向你本地启动的 AutoHotkey MCP 服务器。
在 Claude 中使用: 配置完成后，在 Claude 中与 AI 交互，Claude 将能够利用 AutoHotkey MCP 服务器提供的工具，例如：
- 你可以让 Claude 分析 AutoHotkey 代码，例如提问： "分析以下 AutoHotkey 代码，并找出潜在问题：\n
```
ahk\n ...你的代码...\n 
```
  "
- 你可以让 Claude 查找 AutoHotkey 函数或变量的信息，例如提问： "查询 MsgBox 函数的用法" 或 "查找与文件路径相关的 AutoHotkey 变量"。

注意: 首次使用工具时，Claude 可能会提示你批准工具使用权限。如果你在配置中设置了 '"autoApprove"'，则已列出的工具将自动批准，无需手动确认。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息