AI导哈

AI确认协议服务器

一个实现AI与用户之间确认协议的MCP服务器，为大型语言模型提供工具以在需要澄清或验证时请求用户确认。

  • by mako10k
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 mako10k/mcp-confirm

使用说明

@mako10k/mcp确认

一个在人工智能和用户之间实现确认协议的MCP服务器。它为LLM提供了工具，以便在需要澄清或验证时请求用户确认。

@mako10k/mcp确认

用于人工智能用户确认和澄清的模型上下文协议（MCP）服务器。该服务器为AI助手（LLM）提供工具，以便在用户需要澄清或验证时要求用户确认。

概述

此MCP服务器实现 模型上下文协议引用规范 以实现AI助手和用户之间的确认和澄清协议。

AI助手可以在以下情况下使用它：

  • 执行前确认行动
  • 澄清模棱两可的请求
  • 验证理解是否正确
  • 问是/否问题
  • 收集用户满意度评级

特性

可用工具

  1. ask_是_否

    • 询问是/否确认问题
    • 当AI需要澄清或验证时使用

  2. confirm_action

    • 执行前确认操作
    • 在确认对话框中包括影响和详细信息

  3. 澄清内容

    • 澄清模棱两可的请求
    • 提供多种解释选项

  4. 验证_理解

    • 验证AI的理解是否正确
    • 在继续之前确认下一步

  5. 收集_评级

    • 收集用户满意度评级
    • 评估AI响应质量

  6. 启发式定制

    • 自定义确认对话框
    • 使用自定义JSON模式

  7. search_logs

    • 搜索确认历史日志
    • 按类型、成功状态、日期范围、响应时间筛选
    • 大型数据集的分页结果

  8. 分析日志

    • 确认历史的统计分析
    • 成功率、响应时间、趋势
    • 按类型、时间段等分组。

安装

# Install globally
npm install -g @mako10k/mcp-confirm

# Or use with npx
npx @mako10k/mcp-confirm

使用GitHub代码空间进行开发

该项目支持使用GitHub Codespace进行开发：

  1. 在GitHub上打开此存储库
  2. 点击“代码”按钮
  3. 选择“代码空间”选项卡
  4. 点击“在main上创建代码空间”
  5. 开发环境将自动设置

有关详细信息，请参阅 Developpent.md.

配置

环境变量

您可以使用环境变量配置服务器：

  • MCP_CONFIRM_LOG_PATH：确认历史日志文件的路径（默认： .mcp-data/confirmation_history.log)
  • MCP_CONFIRM_TIMEOUT_MS：确认的默认超时时间（毫秒）（默认值： 180000 =3分钟）
    • 最低要求： 5000 （5秒）
    • 最大值： 1800000 （30分钟）
    • 无效值将返回默认值并发出警告
  • NODE_ENV：设置为 development 启用调试日志记录

超时配置示例

# Use 5-minute timeout
export MCP_CONFIRM_TIMEOUT_MS=300000

# Use 1-minute timeout  
export MCP_CONFIRM_TIMEOUT_MS=60000

# Use 10-second timeout (minimum enforced)
export MCP_CONFIRM_TIMEOUT_MS=10000

超时行为

服务器根据确认类型使用智能超时设置：

  • 关键行动 （删除、移除操作）：120秒
  • 警告措施：90秒
  • 简单的是/否问题：30秒
  • 评级请求：20秒（仅供参考）
  • 其他确认：60秒（默认）

确认历史记录

所有确认交互都记录到一个文件中以供审计。日志包括：

  • 请求的时间戳
  • 确认类型
  • 完整的请求和响应数据
  • 响应时间（毫秒）
  • 成功/失败状态
  • 错误消息（如有）

日志目录(.mcp-data/)如果它不存在，将自动创建。

VS代码集成

添加到您的 .vscode/mcp.json:

{
  "servers": {
    "mcp-confirm": {
      "type": "stdio",
      "command": "npx",
      "args": ["@mako10k/mcp-confirm"]
    }
  }
}

Claude桌面配置

添加到您的Claude桌面 config.json:

视窗

地点： %APPDATA%\Claude\config.json

macOS

地点： ~/Library/Application Support/Claude/config.json

Linux

地点： ~/.config/claude/config.json

{
  "mcp": {
    "servers": {
      "mcp-confirm": {
        "command": "npx",
        "args": ["@mako10k/mcp-confirm"],
        "env": {
          "MCP_CONFIRM_LOG_PATH": "~/.mcp-data/confirmation_history.log",
          "MCP_CONFIRM_TIMEOUT_MS": "60000",
          "NODE_ENV": "production"
        }
      }
    }
  }
}

使用示例

基本确认

// Before AI executes an action
await confirm_action({
  action: "Delete files",
  impact: "Cannot be restored",
  details: "10 files will be deleted"
});

意图澄清

// When request is ambiguous
await clarify_intent({
  request_summary: "Want to create a project",
  ambiguity: "Type of project unclear",
  options: ["Node.js project", "Python project", "React app"]
});

了解验证

// Before complex tasks
await verify_understanding({
  understanding: "Create web application with user authentication",
  key_points: ["React + Node.js", "JWT authentication", "PostgreSQL database"],
  next_steps: "Create project structure then implement auth system"
});

技术规格

  • 协议：模型上下文协议提取
  • 语言：TypeScript
  • 运行时：Node.js
  • SDK版本：@modelcontextprotocol/sdk^1.0.0

运作原理

此服务器实现了真正的MCP激发协议：

  1. 发送 elicitation/create 方法到客户端
  2. 使用JSON模式定义用户输入结构
  3. 用户响应如下 accept, decline，或 cancel
  4. 在…上 accept，按照架构接收结构化数据

这使得AI和用户之间能够进行可靠的通信。

发展

# Clone repository
git clone https://github.com/mako10k/mcp-confirm.git
cd mcp-confirm

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

# Quality checks
npm run quality

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

仓库

  • GitHub: https://github.com/mako10k/mcp-confirm
  • npm: https://www.npmjs.com/package/@mako10k/mcp确认

相关 MCP