Human In The Loop MCP

人在环MCP

实现MCP（模型上下文协议）服务器的VS代码扩展 人在循环 互动。它允许任何兼容MCP的AI代理直接在VS Code中请求用户输入、确认或选择。

⭐ 享受这个扩展？ 如果你觉得它有用，请 在VS Code Marketplace上对其进行评分 --您的反馈有助于其他开发人员发现它！

什么是循环中的人类？

人类在循环（HITL） 是一种AI代理可以暂停执行以请求人工输入、验证或决策的模式。这对于以下方面至关重要：

• 🔐 安全：在破坏性操作之前获得明确许可
• 🎯 准确度：向用户澄清不明确的要求
• 🔧 灵活性：收集无法预测的动态输入
• ✅ 信任：让人类了解并控制人工智能行动

特性

安装

来自VS代码市场

1. 打开VS代码
2. 转到扩展(Ctrl+Shift+X / Cmd+Shift+X)
3. 搜索“人类在环MCP”
4. 单击安装

源自源头

git clone https://github.com/DercasDrol/human-in-the-loop-mcp.git
cd human-in-the-loop-mcp
npm install
npm run compile
# Press F5 in VS Code to launch debug mode

快速开始

1.配置您的AI代理

将MCP服务器添加到项目的 .vscode/mcp.json:

{
  "servers": {
    "human-in-the-loop": {
      "url": "http://127.0.0.1:3847/mcp"
    }
  }
}

备注：扩展会自动检测此配置，并在指定端口上启动服务器。

2.使用侧边栏面板

1. 点击 循环中的人类 活动栏中的图标
2. 当您的AI代理发送请求时，它会出现在面板中
3. 倒计时器显示剩余的响应时间
4. 输入您的回答或单击相应的按钮

键盘快捷键

小贴士：使用 Shift+Enter 要编写多行响应，则 Enter 发送。

可用的MCP工具

您的AI代理可以使用这些工具与用户交互：

ask_user_text

请求用户输入自由格式的文本。

用于：API密钥、文件路径、自定义名称、说明、说明

{
  "name": "ask_user_text",
  "arguments": {
    "title": "API Key Required",
    "prompt": "Please enter your **OpenAI API key**:\n\nYou can find it at [platform.openai.com](https://platform.openai.com/api-keys)",
    "placeholder": "sk-..."
  }
}

ask_user_confirm

请求用户确认是/否。

用于：破坏性操作、许可请求、验证

{
  "name": "ask_user_confirm",
  "arguments": {
    "title": "Confirm Deletion",
    "message": "Are you sure you want to delete the following files?\n\n- `src/old-module.ts`\n- `tests/old-module.test.ts`\n\n⚠️ **This action cannot be undone.**"
  }
}

ask_user_buttons

提供多个选项供用户选择。

用于：语言选择、操作菜单、配置选项

{
  "name": "ask_user_buttons",
  "arguments": {
    "title": "Select Framework",
    "message": "Which framework would you like to use for this project?",
    "options": [
      { "label": "React", "value": "react" },
      { "label": "Vue.js", "value": "vue" },
      { "label": "Angular", "value": "angular" },
      { "label": "Svelte", "value": "svelte" }
    ]
  }
}

设置

在VS代码设置中配置扩展(Ctrl+,):

声音类型

• default -标准通知（简短）
• chime -柔和的蜂鸣声（短）
• ping -快速ping（短）
• bell -带谐波的钟（中等）
• notification -双音升调（中号）
• alert -引人注目的蜂鸣声（长）
• melody -音乐短语C-E-G-C（长）

建筑

┌─────────────────┐     ┌──────────────────┐
│    AI Agent     │────▶│   MCP Server     │
│ (Any MCP Client)│◀────│  (HTTP/JSON-RPC) │
└─────────────────┘     └────────┬─────────┘
                                 │
                                 ▼
                        ┌──────────────────┐
                        │   VS Code        │
                        │   Extension      │
                        └────────┬─────────┘
                                 │
                                 ▼
                        ┌──────────────────┐
                        │  Sidebar Panel   │
                        │  (User Interface)│
                        └──────────────────┘

会话隔离

每个VS代码窗口：

• 在唯一端口上运行自己的HTTP服务器
• 有自己的侧边栏面板
• 独立处理请求

这使得可以同时处理多个项目而不会发生冲突。

兼容性

此扩展适用于 支持模型上下文协议（MCP）的任何AI代理或工具，包括：

• 支持MCP的VS代码扩展
• 实现MCP客户端的CLI工具
• 使用MCP SDK的自定义AI代理
• 任何可以发送JSON-RPC请求的HTTP客户端

命令

隐私和安全

此扩展：

• ✅ 在您的计算机上完全本地运行
• ✅ 不收集任何遥测或分析
• ✅ 不向外部服务器发送数据
• ✅ 所有通信都在VS Code和您的本地AI代理之间进行
• ✅ 默认情况下，绑定到 0.0.0.0 WSL/远程兼容性（可配置为 127.0.0.1)

WSL和远程开发

此扩展完全支持VS代码远程开发：

• Windows 子系统 for Linux （Linux的Windows子系统）
• 远程-SSH
• 开发容器
• GitHub代码空间

运作原理

在远程环境中工作时，扩展程序在 工作区上下文 （远程机器）。VS Code会自动将MCP服务器端口转发到您的本地计算机。

绑定地址设置

如果你只在本地工作，想要更严格的网络隔离，你可以改变 humanInTheLoop.bindAddress 到 127.0.0.1.

需求

• VS代码1.100.0或更高
• Node.js 20+（用于开发；VS Code包括自己的运行时）

贡献

欢迎投稿！请随时提交拉取请求。

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

发布过程

此项目使用GitHub Actions进行自动发布：

1. 更新版本 package.json
2. 创建并推送版本标签： git tag v1.0.1 && git push --tags
3. GitHub操作将自动：

- 构建扩展 - 使用VSIX创建GitHub版本 - 发布到VS代码市场（如果 VSCE_PAT 机密已配置） - 发布到打开的VSX注册表（如果 OVSX_PAT 机密已配置）

许可证

MIT许可证-请参阅 许可证 了解详情。

更新日志

看 更改日志.md 版本历史。

______________________________________________________________________

制作❤️ 对于AI社区