热连线mcp
MCP(模型上下文协议)服务器 热线 多代理工作流编排。
为什么开源?
此MCP服务器在您的计算机上运行。我们将其开源,以便您可以:
- 审计 到底是什么代码在你的机器上运行
- 验证 没有外部网络呼叫
- 信任 没有隐藏的行为
- 从源代码构建 如果你愿意
Hotwired.sh架构
所有内容都在您的机器上本地运行。 没有外部服务依赖关系。```mermaid
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
~/.hotwired/hotwired.sock"] <--> core["Hotwired Core"]
end
agents -->|"spawns"| mcp
ipc <-->|"local only"| socket
### 运作原理
1. **有线桌面应用程序** 在本地运行并在以下位置创建Unix套接字 `~/.hotwired/hotwired.sock`
1. **AI代理** (Claude Code、Gemini等)运行 `hotwired-mcp` 作为他们的MCP服务器
1. **热连线mcp** 通过本地Unix套接字与桌面应用程序通信
1. **无外部网络呼叫** -所有通信都保留在您的机器上
Hotwired Desktop App唯一的外部连接是 **认证**所有工作流编排、消息传递和协调都完全在本地进行。
## 安装
### 适用于Claude Code用户
Hotwired需要MCP服务器和Claude插件才能实现完整功能。
**步骤1:添加MCP服务器**```bash
claude mcp add hotwired -- npx @hotwired-sh/hotwired-mcp@latest
步骤2:安装Claude插件
该插件提供会话挂钩和斜线命令,将Claude Code与Hotwired工作流集成在一起:```bash
claude plugin marketplace add hotwired-sh/claude-plugin
claude plugin install hotwired@hotwired-sh/claude-plugin
请参阅 有线克劳德插件 了解更多详情。
### 适用于其他MCP兼容代理
添加到MCP配置中:```json
{
"mcpServers": {
"hotwired": {
"command": "npx",
"args": ["@hotwired-sh/hotwired-mcp@latest"]
}
}
}
从源头构建
如果你更喜欢自己审计和构建代码:```bash
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`)
- 源代码完全可审计
## 发展```bash
# Build
cargo build --release
# Test
cargo test
# Run locally
cargo run
许可证
麻省理工学院-参见 许可证
了解更多
访问 hotwired.sh 获取有关多代理工作流编排的文档、教程和更多信息。
