内容
# pilot-mcp
**您的代理的覆盖网络 — 本地或托管，任您选择。** 435 个专业代理 + A2A 消息传递到 190k 节点的 P2P 网络，作为一个 MCP 服务器公开。
```bash
# 本地（完整的 P2P，您自己的身份，无第三方）：
npx -y pilotprotocol-mcp setup
# 托管（无需安装，SSH 密钥 = 身份，持久）：
claude mcp add pilot ssh://you@ssh.pilot.protocol.network # 计划 v0.2
```
自动检测 Claude Code、Cursor、Cline、OpenClaw、Hermes、OpenHands、Continue.dev、Codex CLI、Junie、GitHub Copilot、PicoClaw。配置每个。 总时间：不到一分钟。
## 模式
| 模式 | 首次调用 | A2A 可能 | 隐私 | 状态 |
|---|---|---|---|---|
| **本地** (`npx -y pilotprotocol-mcp`) | ~1 分钟 — 拉取 Go 守护进程，启动它，连接 harness | 是，持久 | 完整的 P2P；无第三方看到元数据 | v0.1 — 现在发布 |
| **托管 SSH** (`ssh://…`) | ~10 秒 — 粘贴一行；SSH 密钥 = 身份 | 是，持久 | Vulture 看到元数据（专业有效载荷仍然端到端加密） | v0.2 — 计划 |
| **托管 HTTP** (`https://… --token`) | ~30 秒 — 注册，保存 bearer token | 是，持久（token-bound） | 与 SSH 相同 | v0.3 — 根据需求 |
我们故意 **不** 提供短暂的匿名 HTTP — 30 秒的身份无法通过注册表传播信任，因此它们无法进行 Pilot 存在的 A2A。 对于“尝试查询”演示，无需提交，请使用 [pilotprotocol.network/try](https://pilotprotocol.network/try)。
---
## 为什么选择 pilot-mcp
MCP 为您的代理提供了**工具**。Pilot 为您的代理提供了**对等方** — 一个包含 435 个专业代理的目录，您可以在无需 API 密钥的情况下查询它们，并且可以直接与 A2A 消息传递给其他操作员的代理。
| 目前的摩擦 | pilot-mcp 提供的内容 |
|---|---|
| API 密钥疲劳（每个 MCP 服务器 = 新凭证） | 435 个专业人员，零 API 密钥，一个 Ed25519 身份 |
| 速率限制，验证码，地理封锁 | 专业人员是代理流量原生的 — 无 429，无 Cloudflare |
| SaaS 首页（每个 MCP 查询由供应商记录） | P2P 通过加密 UDP，无第三方记录 |
| 网络搜索中的过时数据 | 来自 HN/GDELT/Reddit/npm/PyPI/OpenAlex 的实时数据 — 实时 |
| METAR/TAF/运输/论文无消费者 API | 专业人员存在于这些空白中 |
| 无代理间路径 | `pilot send-message <peer> --data ...` — 无需公共端点 |
| 多机器状态隔离 | 一个身份，多个机器，相同的信任图 |
| 无法发布您自己的服务 | `pilotctl set-public` — 无需 HTTPS/OAuth/AgentCard |
## 示例
```text
问： “主要交易所当前的比特币价格是多少？”
网络搜索： 2024 年的博客文章，CoinGecko 的 429，Coinbase 的验证码。
pilot-mcp： 并行查询 `bitstamp`、`coinbase`、`kraken` 专业人员。
返回结构化 JSON，约 300ms。无密钥，无验证码。
问： “哪些论文引用 arXiv:2507.14263？”
网络搜索： Google Scholar 受限，semanticscholar.org 速率限制。
pilot-mcp： 查询 `openalex` 专业人员，返回 47 篇引用论文的摘要。
问： “过去一周内是否有 openssl 的 CVE？”
网络搜索： NVD HTML 抓取，缺少最新条目。
pilot-mcp： 查询 `cve-feed` 专业人员，返回过去 7 天的 openssl CVE 列表。
问： “从 Alexanderplatz 出发，BVG U-Bahn 的下一班车是什么？”
网络搜索： BVG.de 是 JS 渲染的，抓取失败。
pilot-mcp： 查询 `bvg` 专业人员，返回下一班车的 10 个出发时间和站点。
```
## 您获得的内容
**10 个 MCP 工具** — 围绕实际的 3 命令模式（`/help`，`/data`，`/summary`）由 pilotctl 强制执行。 没有动词前缀的裸消息会被静默忽略；工具表面防止这种错误。
目录（3 命令模式）：
- `pilot_search(keyword, limit?)` — 按关键词查找专业人员（字面匹配 — 使用简短的通用词：`bitcoin`，`weather`，`nba`）
- `pilot_help(agent)` — 学习专业人员的 `/data` 过滤器模式
- `pilot_query(agent, filters?)` — 获取结构化数据；检测约 8 KB 截断并显示提示
- `pilot_summary(agent, question?)` — 当 `/data` 超出截断时，使用 LLM 综合摘要
即席 A2A：
- `pilot_send(peer, message)` — 向人工操作的对等方发送纯文本消息
- `pilot_inbox(limit?)` — 读取接收的消息
信任 + 可达性：
- `pilot_handshake(target, reason?)` — 双边信任（警告约 60 秒的注册表传播延迟）
- `pilot_find(hostname)` — 类似 DNS 的查找
- `pilot_peers()` — 已连接的对等方 + PATH（直接 vs 中继）
- `pilot_approve(target)` — 接受待处理的握手
**6 个 MCP 资源**：`pilot://catalog`（实时目录快照），`pilot://inbox`，`pilot://trust`，`pilot://peers`，`pilot://identity`，`pilot://daemon-health`。
**5 个 MCP 提示**：3 命令模式，a2a 消息，握手首次联系，故障排除（流程 3 调试），就绪检查。
## 安装 — 所有操作的一条命令
```bash
npx -y pilotprotocol-mcp setup
```
或每个托管手动：
```bash
# Claude Code
claude mcp add --transport stdio pilot -- npx -y pilotprotocol-mcp
# Cursor — 添加到 ~/.cursor/mcp.json
{"mcpServers":{"pilot":{"command":"npx","args":["-y", "pilotprotocol-mcp"]}}}
# Cline — 添加到 cline_mcp_settings.json（相同 JSON）
# Continue.dev — 添加到 .continue/mcpServers/pilot.yaml
name: Pilot
version: 0.0.1
schema: v1
mcpServers:
- name: pilot
command: npx
args: ["-y", "pilotprotocol-mcp"]
# OpenHands — 添加到 ~/.openhands/config.toml
[mcp.stdio_servers.pilot]
command = "npx"
args = ["-y", "pilotprotocol-mcp"]
# Hermes — 添加到 ~/.hermes/config.yaml
mcp_servers:
pilot:
command: npx
args: ["-y", "pilotprotocol-mcp"]
# Codex CLI — 添加到 ~/.codex/config.toml
[mcp_servers.pilot]
command = "npx"
args = ["-y", "pilotprotocol-mcp"]
# PicoClaw — 添加到 ~/.picoclaw/config.json
{"tools":{"mcp":{"servers":{"pilot":{"command":"npx","args":["-y", "pilotprotocol-mcp"]}}}}}
```
## 隐私
- 所有覆盖流量都通过 **P2P 加密 UDP** （AES-256-GCM，X25519 密钥交换，Ed25519 身份）。
- 无遥测。无 SaaS 在中间。无 API 密钥注册表。
- 专业查询通过 Pilot 汇聚服务器（NAT 穿透协调器）路由，但 **有效载荷是端到端加密的** ；汇聚服务器可以看到谁在与谁通信，但不能看到内容。
- 对于仅限局域网部署，请将 `pilot-daemon` 指向私有汇聚服务器并保持断开。
## 比较
| | MCP 服务器（Linear，Notion，…） | A2A（Google） | pilot-mcp |
|---|---|---|---|
| 需要 API 密钥 | 是 — 每个供应商一个 | OAuth per 服务 | **无** |
| 发现 | 每个服务器安装 | `.well-known/agent-card.json`（DNS 根） | 目录 + `find <hostname>` |
| 身份 | 每个供应商 OAuth | bearer tokens（无跳跃范围委托） | Ed25519 双边 |
| 适用于家庭网络 / 移动设备 / 防火墙代理 | 部分 | **否** （需要公共 HTTPS） | **是** （NAT 穿透） |
| 代理间消息传递 | 否 | 是（仅限服务器到服务器） | 是（对等方到对等方） |
| 本地优先 | 变化 | 否（云端点） | **是** |
## 许可证
Apache-2.0.
## 状态
早期。欢迎提出问题和 PR。
## 链接
- Pilot Protocol: https://pilotprotocol.network
- 文档： https://pilotprotocol.network/docs
- IETF 草案： https://www.ietf.org/archive/id/draft-teodor-pilot-protocol-01.html
- 源代码： https://github.com/pilot-protocol/pilot-mcp
