Skip to main content
Glama

chathook — AI 对话钩子 MCP Server

在 AI 完成任务后弹出原生输入对话框,让用户直接输入回复,保持对话不中断,直到用户明确结束。

工作原理

用户提问 → AI 处理任务 → AI 调用 chat_hook 工具
                                    ↓
                    弹出原生桌面对话框(输入框 + 提交按钮 + 倒计时)
                                    ↓
                     用户输入回复 / 关闭对话框结束
                                    ↓
                    工具返回用户输入 → AI 继续处理
                                    ↓
                        AI 再次调用 chat_hook ...
                                    ↓
                      用户关闭对话框 → 工具返回结束信号
                                    ↓
                         AI 结束回合,对话完成

Related MCP server: mcp-interactive-ui-server

安装

方式一:npx 从 npm 安装(推荐)

在 MCP 客户端的配置中添加:

{
  "mcpServers": {
    "chathook": {
      "command": "npx",
      "args": ["-y", "mcp-chathook"]
    }
  }
}

方式二:npx 从 GitHub 安装

{
  "mcpServers": {
    "chathook": {
      "command": "npx",
      "args": ["-y", "github:kedaya2025/mcp-chathook"]
    }
  }
}

方式三:本地运行

git clone https://github.com/kedaya2025/mcp-chathook.git
cd mcp-chathook
npm install
npm run build
{
  "mcpServers": {
    "chathook": {
      "command": "node",
      "args": ["<path-to>/mcp-chathook/dist/index.js"]
    }
  }
}

使用方法

系统提示词配置

在 AI Agent 的系统提示词 / 自定义指令中添加:

所有对话或任务结束时,都必须调用 chathook 工具来向用户确认工作进程,
除非用户结束该工具的调用视为任务完成不再调用。

License

MIT

Available Tools

1 tool
chat_hookA

Display an input dialog to the user and wait for their response.

IMPORTANT: After completing a task or response, you SHOULD call this tool to ask the user if they need anything else. This keeps the conversation alive without requiring the user to type a new message.

The tool will block until the user responds. Possible return values:

  • Normal text: The user's new request or feedback. Continue working.

  • [CHATHOOK:USER_DECLINED]: The user clicked 'Decline' (end conversation). Stop calling this tool and end your response.

  • [CHATHOOK:USER_CANCELLED]: The user cancelled the input. You may end your response or call this tool again.

Inputs: message (required), suggestions.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.8/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion. The tool's purpose is clearly distinct.

    Naming Consistency5/5

    The single tool name 'chat_hook' uses a consistent underscore convention, which is fine for a single tool.

    Tool Count3/5

    The server has only one tool, which is at the low end of acceptable. While it serves a specific purpose, typically servers have more tools to cover broader functionality.

    Completeness5/5

    The single tool fully covers the server's purpose of user interaction. It handles input and special cases (decline, cancel) through return values, so no gaps are apparent.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI models to interactively prompt users for input or clarification directly through their code editor. It facilitates real-time communication between assistants and users during development tasks.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to render interactive user interfaces such as forms, dashboards, charts, tables, and wizards directly in MCP-compatible clients. Supports structured data collection and richer interactions beyond text responses.
      6
      13 PyPI
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to ask clarification questions and receive structured user input through a Human-in-the-Loop interface.
      1
      MIT