• 项目简介
    • 该仓库实现了一个基于 MCP(Model Context Protocol)的后端服务器,用于向大语言模型客户端提供可访问的资源、可执行的工具以及可渲染的提示模板,以便在对 AutoHotkey v2 代码的上下文理解和生成任务中提供结构化服务。
  • 主要功能点
    • MCP 协议实现:通过 JSON-RPC 方式接收请求并返回标准化响应或通知。
    • 资源、工具、Prompts 的托管与管理:实现资源读取、工具注册/执行、Prompt 列表与获取等能力。
    • 自动化上下文注入:可根据输入自动注入 AutoHotkey v2 的文档、模板和示例以辅助 LLM 推理。
    • 支持多传输协议:包括 stdio(Claude Desktop 之类的直接集成)、SSE(与 ChatGPT 兼容的增量传输)等。
    • 会话与能力声明:服务器端维护会话状态、任务与能力声明,提供分析、执行、日志等能力。
    • 数据加载与文档索引:内置对 AutoHotkey v2 数据和索引的加载与查询。
    • 集成工具集合:如 AHK_Smart_Orchestrator、AHK_Diagnostics、AHK_Run、AHK_LSP 等多样化工具。
    • 资源模板与内置 Prompts:提供多种内置 AutoHotkey Prompts 及模板,便于快速构建对话上下文。
  • 安装步骤
    1. 安装 Node.js 18 及以上版本。
    2. 获取代码并安装依赖:
      • npm install
    3. 构建项目:
      • npm run build
    4. 启动服务器(默认 STDIO 传输,CLI/Claude 集成时也可启用 SSE):
      • npm start
    5. 如需在开发环境中热重载:
      • npm run dev
  • 服务器配置(MCP 客户端需要知道的连接信息)
    • 服务器名称: ahk-mcp-server
    • 启动命令(command): node
    • 启动参数(args): dist/index.js
    • 传输类型(transportType): stdio
    • 环境变量(env)示例:
      • NODE_ENV=production
      • AHK_MCP_LOG_LEVEL=warn
    • 说明:MCP 客户端通常通过上述信息建立与 MCP 服务器的连接。若需要使用 SSE 传输以对接 ChatGPT,请在服务器端启用 SSE 转发并暴露 /sse、/message 等端点(详见实现代码)。
    • 注:以上信息根据仓库中的实现与启动脚本生成,确保与实际部署路径一致。
  • 基本使用方法
    • 启动后,客户端通过 MCP 协议向服务器发送 JSON-RPC 请求,例如:
      • initialize:初始化会话、声明能力
      • tools/list、tools/call、resources/list、resources/read、prompts/list、prompts/get 等请求以获取工具、资源与提示模板
    • 客户端可在标准输出/错误输出中接收响应,或通过 SSE 传输接收持续通知。
    • 常用场景:LLM 获取工具清单以执行外部功能、读取 AutoHotkey 资源以注入上下文、执行 AHK 脚本、获取 Prompts 以指导对话等。
    • 脚本化集成建议:结合 MCP 的 json-rpc 请求/响应格式,通过统一客户端调用入口与错误处理,构建可重复的学习/开发工作流。

信息

分类

开发者工具