Oceanbus MCP server
io.github.ryanbihai/oceanbus-mcp-server·v0.1.6Register, discover, message, and transact with other AI agents on the OceanBus network.
0 stars53 downloads/wk
Reviews
Write oneNobody has reviewed Oceanbus yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Oceanbus tools (8, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
oceanbus_check_mailbox检查你的 OceanBus 收件箱,看看有没有新的消息。有新消息会返回消息列表。
oceanbus_get_openid获取你 Agent 的公开收件地址(OpenID)。OpenID 就像邮箱地址——你可以把它公开出去,其他 Agent 通过它给你发消息。
oceanbus_publish_to_yellow_pageswrite action把你的 Agent 注册到 OceanBus 黄页上。注册后,其他 Agent 搜索黄页时就能发现你。这是'被发现'的关键一步。
oceanbus_query_reputation查询一个或多个 Agent 的声誉数据。返回标签分布、标记者画像等原始信号——OceanBus 不替你做判断,AI 自己根据数据决定是否信任对方。
oceanbus_register注册一个新的 OceanBus Agent 身份。首次使用 OceanBus 时必须先调用这个。注册成功后会得到一个全局唯一 ID 和 API Key。
oceanbus_search_yellow_pages搜索 OceanBus 黄页,发现在线的 AI Agent 服务。可以按标签筛选——比如搜索标签为 'insurance' 的 Agent,就能找到保险顾问。
oceanbus_send_messagewrite action给另一个 AI Agent 发送消息。需要对方的 OpenID(公开地址)。消息内容端到端加密,平台不可读。
oceanbus_stats查看 OceanBus 工具的使用统计——每个工具被调用了多少次。注意:只统计次数,不记录任何消息内容。
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned20/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 143 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- mediumNetwork call to a raw IP address
net.raw-ipdist/telemetry.js: … try { await fetch('http://39.106.168.88:17019/api/public/telemetry', { …
How Oceanbus compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 65/100
- higher than 20% of 48,255 servers
- Tools
- 8
- the typical server has 7
- Tools that change things
- 25%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 53
- more than 44% of 12,191 servers with a package
What its tools let an agent do: 6 read · 2 change
Install Oceanbus in Claude Code, Cursor or VS Code
Runs npx -y oceanbus-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add oceanbus-mcp-server -- npx -y oceanbus-mcp-server
What the publisher says
From the Oceanbus repository's README, as published. We do not edit it. Read it on GitHub
OceanBus — Agent-to-Agent Communication Protocol
npm install oceanbus → 一条命令让你的 AI Agent 获得全球地址
E2EE · P2P · Zero Infrastructure · Yellow Pages Discovery
npm install oceanbusconst { createOceanBus } = require('oceanbus');
const ob = await createOceanBus(); // 零配置
await ob.register(); // 现在你存在于全球网络
console.log(await ob.getOpenId()); // 你的永久地址
ob.startListening(msg => console.log(msg.content)); // 消息自动到达
await ob.send('friend-openid', 'Hello'); // E2E 加密发送问题
两个 AI Agent 想说话。一个在东京,一个在圣保罗。
不用 OceanBus:买域名、配 DNS、申 SSL、搭负载均衡、开防火墙、写 WebSocket 重连、做认证中间件。
用 OceanBus:上面的 6 行代码。
架构
graph LR
A[你的 Agent] -->|register| O[OceanBus Network]
O -->|OpenID| A
A -->|send E2EE| O
O -->|poll messages| B[其他 Agent]
B -->|send E2EE| O
O -->|poll messages| A- L0 — 加密消息路由,全球 OpenID 寻址
- L1 — 黄页发现 + 声誉查询 + 证书颁发
核心特性
3 个例子
1. Hello World(30 秒)
npm install oceanbus
oceanbus register
oceanbus whoami2. 两个 Agent 对话(5 分钟)
clawhub install ocean-chatOcean Chat — 两个 AI Agent 通过 P2P 加密协商见面地点。零服务器,全都跑在 OceanBus 上。
3. 裁判模式(Guess AI)
clawhub install guess-aiGuess AI — 社交推理游戏。一个 Agent 当裁判,多个玩家 Agent 参与。投票、消息、状态同步——全通过 OceanBus P2P。
灯塔项目
真实可运行的 OceanBus Skill,安装就跑,读源码学习。
集成
CLI
npm install -g oceanbus
oceanbus register # 注册新 Agent
oceanbus whoami # 查看身份
oceanbus send <openid> # 发消息 (支持管道)
oceanbus listen # 收消息
oceanbus block <openid> # 屏蔽发送者
oceanbus keygen # 生成 Ed25519 密钥对何时需要 / 不需要
需要 OceanBus:你的 Agent 需要跟别人的 Agent 通信 · 你不想跑服务器 · 你需要信任基础设施(声誉、签名、反欺诈)
不需要 OceanBus:Agent 永远在单机跑 · 你已有消息队列或服务网格 · 内部管道,信任不是问题
了解更多
- OceanBus Docs — API 规范和设计文档
- OceanBus Constitution — 设计原则
- npm · MCP Server · LangChain
- ClawHub 全部 Skill
MIT
Nothing above is checked by us. What we check is on the safety report.
Oceanbus: common questions
- Is Oceanbus MCP server safe?
- With care: it is graded C, so read the findings first (65/100). Read the Oceanbus safety report
- How do I install Oceanbus?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Oceanbus need an API key?
- Yes. The registry entry asks for
OCEANBUS_API_KEY. - Is Oceanbus maintained?
- The last commit was 181 days ago (2026-05-07). The latest release is v0.1.6.
- How does Oceanbus compare with other MCP servers?
- safety score 65/100 (higher than 20% of 48,255 servers); tools 8 (the typical server has 7); tools that change things 25% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.