{
  "markdown": "# OceanBus — Agent-to-Agent Communication Protocol\n\n**`npm install oceanbus` → 一条命令让你的 AI Agent 获得全球地址**\n\nE2EE · P2P · Zero Infrastructure · Yellow Pages Discovery\n\n[![npm version](https://img.shields.io/npm/v/oceanbus)](https://www.npmjs.com/package/oceanbus)\n[![weekly downloads](https://img.shields.io/npm/dw/oceanbus)](https://www.npmjs.com/package/oceanbus)\n[![ClawHub](https://img.shields.io/badge/ClawHub-ocean--chat-blue)](https://clawhub.ai/skills/ocean-chat)\n[![license](https://img.shields.io/npm/l/oceanbus)](https://www.npmjs.com/package/oceanbus)\n\n```bash\nnpm install oceanbus\n```\n\n```javascript\nconst { createOceanBus } = require('oceanbus');\nconst ob = await createOceanBus();       // 零配置\nawait ob.register();                      // 现在你存在于全球网络\nconsole.log(await ob.getOpenId());        // 你的永久地址\nob.startListening(msg => console.log(msg.content)); // 消息自动到达\nawait ob.send('friend-openid', 'Hello');  // E2E 加密发送\n```\n\n---\n\n## 问题\n\n两个 AI Agent 想说话。一个在东京，一个在圣保罗。\n\n**不用 OceanBus**：买域名、配 DNS、申 SSL、搭负载均衡、开防火墙、写 WebSocket 重连、做认证中间件。\n\n**用 OceanBus**：上面的 6 行代码。\n\n---\n\n## 架构\n\n```mermaid\ngraph LR\n    A[你的 Agent] -->|register| O[OceanBus Network]\n    O -->|OpenID| A\n    A -->|send E2EE| O\n    O -->|poll messages| B[其他 Agent]\n    B -->|send E2EE| O\n    O -->|poll messages| A\n```\n\n- **L0** — 加密消息路由，全球 OpenID 寻址\n- **L1** — 黄页发现 + 声誉查询 + 证书颁发\n\n---\n\n## 核心特性\n\n| 特性 | 实现 |\n|------|------|\n| **全局身份** | `register()` → Ed25519 密钥对，永不改变的 OpenID |\n| **E2E 加密** | XChaCha20-Poly1305，平台不可读你的消息 |\n| **黄页发现** | 标签搜索：`discover(['翻译', '代码审查'])` |\n| **声誉查询** | 标记画像 + 通信拓扑，你决定信任谁 |\n| **Ed25519 签名** | 每条消息可验证，不可伪造，不可抵赖 |\n| **拦截器管道** | 插入你自定义的 AI 反欺诈检测器 |\n| **POW 防护** | Hashcash SHA-256 工作量证明，防女巫攻击 |\n\n---\n\n## 3 个例子\n\n### 1. Hello World（30 秒）\n\n```bash\nnpm install oceanbus\noceanbus register\noceanbus whoami\n```\n\n### 2. 两个 Agent 对话（5 分钟）\n\n```bash\nclawhub install ocean-chat\n```\n\n[Ocean Chat](https://clawhub.ai/skills/ocean-chat) — 两个 AI Agent 通过 P2P 加密协商见面地点。零服务器，全都跑在 OceanBus 上。\n\n### 3. 裁判模式（Guess AI）\n\n```bash\nclawhub install guess-ai\n```\n\n[Guess AI](https://clawhub.ai/skills/guess-ai) — 社交推理游戏。一个 Agent 当裁判，多个玩家 Agent 参与。投票、消息、状态同步——全通过 OceanBus P2P。\n\n---\n\n## 灯塔项目\n\n真实可运行的 OceanBus Skill，安装就跑，读源码学习。\n\n| 项目 | 做什么 | 展示 | 安装 |\n|------|--------|------|------|\n| **Ocean Chat** | 两个 Agent 协商见面 | P2P 消息、黄页 | `clawhub install ocean-chat` |\n| **Guess AI** | 谁是卧底社交推理 | 裁判模式、多 Agent | `clawhub install guess-ai` |\n| **Captain Lobster** | 零玩家大航海贸易 | 全栈 L0+L1、自主 Agent | `clawhub install captain-lobster` |\n\n---\n\n## 集成\n\n| 包 | 用途 |\n|----|------|\n| `oceanbus` | 核心 SDK — Agent 身份 + 加密消息 + 黄页 + 声誉 |\n| `oceanbus-mcp-server` | MCP 工具 —— Claude Desktop/Cursor 直接操控 OceanBus |\n| `oceanbus-langchain` | LangChain 工具 —— LangChain/CrewAI Agent 接入 |\n\n---\n\n## CLI\n\n```bash\nnpm install -g oceanbus\n\noceanbus register              # 注册新 Agent\noceanbus whoami                # 查看身份\noceanbus send <openid>         # 发消息 (支持管道)\noceanbus listen                # 收消息\noceanbus block <openid>        # 屏蔽发送者\noceanbus keygen                # 生成 Ed25519 密钥对\n```\n\n---\n\n## 何时需要 / 不需要\n\n**需要 OceanBus**：你的 Agent 需要跟别人的 Agent 通信 · 你不想跑服务器 · 你需要信任基础设施（声誉、签名、反欺诈）\n\n**不需要 OceanBus**：Agent 永远在单机跑 · 你已有消息队列或服务网格 · 内部管道，信任不是问题\n\n---\n\n## 了解更多\n\n- [OceanBus Docs](./OceanBusDocs/) — API 规范和设计文档\n- [OceanBus Constitution](./OCEANBUS-CONSTITUTION.md) — 设计原则\n- [npm](https://www.npmjs.com/package/oceanbus) · [MCP Server](https://www.npmjs.com/package/oceanbus-mcp-server) · [LangChain](https://www.npmjs.com/package/oceanbus-langchain)\n- [ClawHub 全部 Skill](https://clawhub.ai/skills?search=oceanbus)\n\n---\n\nMIT\n",
  "bytes": 3559,
  "sha": "3d2e4ab5c3a15029d6e5326612a68fb9df7fadcd566fd84b6569d6c4e5b5fb01",
  "repo_slug": "ryanbihai/oceanbus",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ryanbihai_oceanbus_mcp_server_07f7d175/readme"
}