多代理工作流编排协议

Hotwired-mcp是一个本地运行的多代理工作流编排协议服务器,支持审计和验证,确保无外部网络调用和隐藏行为。

  • by hotwired-sh
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 hotwired-sh/hotwired-mcp

使用说明

热连线mcp

MCP(模型上下文协议)服务器 热线 多代理工作流编排。

为什么开源?

此MCP服务器在您的计算机上运行。我们将其开源,以便您可以:

  • 审计 到底是什么代码在你的机器上运行
  • 验证 没有外部网络呼叫
  • 信任 没有隐藏的行为
  • 从源代码构建 如果你愿意

Hotwired.sh架构

所有内容都在您的机器上本地运行。 没有外部服务依赖关系。

flowchart TB
    subgraph agents["AI Coding Agents"]
        claude["Claude Code"] ~~~ gemini["Gemini CLI"] ~~~ other["Other Agents"]
    end

    subgraph mcp["hotwired-mcp"]
        tools["MCP Tools"] --> ipc["IPC Client"]
    end

    subgraph desktop["Hotwired Desktop App"]
        socket["Unix Socket<br/>~/.hotwired/hotwired.sock"] <--> core["Hotwired Core"]
    end

    agents -->|"spawns"| mcp
    ipc <-->|"local only"| socket

运作原理

  1. 有线桌面应用程序 在本地运行并在以下位置创建Unix套接字 ~/.hotwired/hotwired.sock
  2. AI代理 (Claude Code、Gemini等)运行 hotwired-mcp 作为他们的MCP服务器
  3. 热连线mcp 通过本地Unix套接字与桌面应用程序通信
  4. 无外部网络呼叫 -所有通信都保留在您的机器上

Hotwired Desktop App唯一的外部连接是 认证所有工作流编排、消息传递和协调都完全在本地进行。

安装

适用于Claude Code用户

Hotwired需要MCP服务器和Claude插件才能实现完整功能。

步骤1:添加MCP服务器

claude mcp add hotwired -- npx @hotwired-sh/hotwired-mcp@latest

步骤2:安装Claude插件

该插件提供会话挂钩和斜线命令,将Claude Code与Hotwired工作流集成在一起:

claude plugin marketplace add hotwired-sh/claude-plugin
claude plugin install hotwired@hotwired-sh/claude-plugin

请参阅 有线克劳德插件 了解更多详情。

适用于其他MCP兼容代理

添加到MCP配置中:

{
  "mcpServers": {
    "hotwired": {
      "command": "npx",
      "args": ["@hotwired-sh/hotwired-mcp@latest"]
    }
  }
}

从源头构建

如果你更喜欢自己审计和构建代码:

cargo install --git https://github.com/hotwired-sh/hotwired-mcp

先决条件

可用工具

工具 说明
get_protocol 获取工作流协议和角色说明
get_run_status 检查当前运行状态
report_status 更新您的工作状态
send_message 向其他参与者发送消息
request_input 征求人们的意见
report_impediment 发出你被封锁的信号
handoff 将工作交给另一名代理人
task_complete 将任务标记为已完成

安全

为什么是Unix套接字(不是HTTP/localhost)

我们故意使用 Unix套接字 而不是本地主机上的HTTP。这是一个关键的安全设计选择。

许多MCP工具容易受到 DNS重新绑定攻击 和 0.0.0.0绕过漏洞 因为它们在本地主机上公开了HTTP服务器。这些漏洞允许恶意网站:

  • 通过DNS重新绑定向localhost服务发送请求
  • 通过0.0.0.0漏洞绕过浏览器同源策略
  • 无需用户交互即可实现远程代码执行

Unix套接字对这些攻击免疫:

  • ❌ 没有TCP/HTTP侦听器-浏览器无法连接
  • ❌ 无法重新绑定DNS-不是网络协议
  • ❌ 没有0.0.0.0旁路-套接字是基于文件系统的
  • ✅ 受文件系统权限保护
  • ✅ 只有本地进程可以连接

此MCP服务器不做什么

  • 不打开任何网络端口 -没有HTTP,没有TCP,没有本地主机
  • 不发出任何外部网络请求
  • 不读取或修改文件 超出其范围
  • 连接 仅 到本地Unix套接字(~/.hotwired/hotwired.sock)
  • 源代码完全可审计

发展

# Build
cargo build --release

# Test
cargo test

# Run locally
cargo run

许可证

麻省理工学院-参见 许可证

了解更多

访问 hotwired.sh 获取有关多代理工作流编排的文档、教程和更多信息。