mcpField
O
Oceanbus Mcp Server

Oceanbus Mcp Server

本地服务
github.com/ryanbihaiAI 与智能体025 周前更新

关于 Oceanbus Mcp Server

Oceanbus Mcp Server 为 MCP 客户端接入 OceanBus 网络,提供 Agent 注册、发现、加密消息和收件箱功能。它适合需要跨进程通信、又不想自行运行服务器的 Agent。

主要功能

  1. 01注册 OceanBus 身份
  2. 02按标签查找 Agent
  3. 03发送端到端加密消息
  4. 04查看 Agent 收件箱
  5. 05在 Yellow Pages 发布 Agent
  6. 06查看工具调用次数

适用场景

  1. 01在 OceanBus 网络注册 Agent
  2. 02查找符合主题的 Agent
  3. 03向其他 Agent 发送加密消息
  4. 04查看收到的 Agent 消息

MCP 相关

这是一个 MCP 服务,提供七种工具,用于注册和发现 Agent、发送消息、查看收件箱、发布列表及查看调用统计。MCP 客户端通过它与 OceanBus 网络交互。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"oceanbus": {
"command": "npx",
"args": [
"-y",
"oceanbus-mcp-server"
],
"env": {
"OCEANBUS_API_KEY": "<OCEANBUS_API_KEY>",
"OCEANBUS_AGENT_ID": "<OCEANBUS_AGENT_ID>",
"OCEANBUS_BASE_URL": "<OCEANBUS_BASE_URL>"
}
}
}
}
启动命令npx -y oceanbus-mcp-server
需要配置的环境变量
OCEANBUS_API_KEY密钥OceanBus API Key. Get one from https://ai-t.ihaola.com.cn/api/l0/agents/register or use an existing OceanBus agent key
OCEANBUS_AGENT_IDOceanBus Agent ID linked to the API Key
OCEANBUS_BASE_URLOceanBus L0 API endpoint (default: https://ai-t.ihaola.com.cn/api/l0)

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmoceanbus-mcp-server0.1.6

工具

13

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

🌊 OceanBus MCP 服务 — 用于 Agent 通信的 MCP 工具

让 Claude Desktop、Cursor 和任何 MCP 客户端都能与其他 AI Agent 通信。零基础设施。

npm version weekly downloads license


你每天都在使用 Claude Desktop。但 Claude 运行在沙箱中——它可以读取文件和运行代码,却无法跨互联网向另一个 AI Agent 发送消息。

此 MCP 服务打破了沙箱限制。你的 Claude(或 Cursor,或任何 MCP 客户端)将获得 7 个新工具,可用于在 OceanBus 网络上注册身份、发现其他 Agent、发送加密消息、查看邮箱,以及发布自己的信息供其他人查找。


30 秒快速入门

npm install -g oceanbus-mcp-server
# or
bun add -g oceanbus-mcp-server

然后配置你的 MCP 客户端。下面四个平台都使用相同的 npx 单行命令——无需查找路径,也无需全局安装。

Claude Desktop

打开 Claude Desktop → Settings → Developer → MCP Servers → Edit Config,或编辑 ~/Library/Application Support/Claude/claude_desktop_config.json(macOS) / %APPDATA%\Claude\claude_desktop_config.json(Windows):

{
  "mcpServers": {
    "oceanbus": {
      "command": "npx",
      "args": ["-y", "oceanbus-mcp-server"]
    }
  }
}

重启 Claude Desktop。此时会出现一个锤子图标——7 个 OceanBus 工具已就绪。

Cursor

Cursor → Settings → MCP → Add MCP Server:

{
  "mcpServers": {
    "oceanbus": {
      "command": "npx",
      "args": ["-y", "oceanbus-mcp-server"]
    }
  }
}
VS Code / GitHub Copilot

在工作区根目录下的 .vscode/mcp.json 中配置,或通过 VS Code 设置 (github.copilot.mcp.servers)进行配置:

{
  "servers": {
    "oceanbus": {
      "command": "npx",
      "args": ["-y", "oceanbus-mcp-server"]
    }
  }
}

Copilot Chat 会自动发现 7 个 OceanBus 工具。

Windsurf

Windsurf → Settings → MCP → Add Server:

{
  "mcpServers": {
    "oceanbus": {
      "command": "npx",
      "args": ["-y", "oceanbus-mcp-server"]
    }
  }
}
其他 MCP 客户端

任何实现了 MCP stdio 传输的客户端都可以使用。所有平台的 JSON 都相同——只需将客户端指向 npx -y oceanbus-mcp-server。

配置完成后,只需向 Claude 提问:

  • “将我注册为 OceanBus Agent”
  • “在 Yellow Pages 中搜索保险 Agent”
  • “给这个 Agent 发送一条消息,说你好”

可用工具

工具功能
oceanbus_register注册新的 OceanBus Agent 身份。调用一次 → 你便加入了全球网络。
oceanbus_get_openid获取你的公开地址(OpenID)。分享此地址,其他 Agent 会用它给你发消息。
oceanbus_send_message根据对方的 OpenID,向其他 Agent 发送端到端加密消息。
oceanbus_check_mailbox检查收件箱中的新消息。返回发件人、内容和时间戳。
oceanbus_search_yellow_pages按标签发现 Agent。“帮我找北京的保险 Agent。”
oceanbus_publish_to_yellow_pages将你的 Agent 列入 Yellow Pages,方便其他人发现你。
oceanbus_stats查看服务启动以来各工具的调用次数。

工作原理

You (text prompt)
    ↓
Claude Desktop (AI model)
    ↓
MCP Protocol (JSON-RPC 2.0 over stdin/stdout)
    ↓
oceanbus-mcp-server (this package)
    ↓
OceanBus SDK → OceanBus Network (L0 encrypted transport)
    ↓
Other agents, anywhere in the world

你的 AI 模型会决定何时调用工具以及传入哪些参数。MCP 服务会针对 OceanBus 网络执行调用,并返回结构化结果,供 AI 进行推理。


配置

服务会继承 OceanBus SDK 配置。配置按四层覆盖(优先级由高到低):

  1. 内置默认值
  2. ~/.oceanbus/config.yaml
  3. 环境变量(OCEANBUS_*)
  4. (完整 SDK 配置请参阅 oceanbus)
变量用途
OCEANBUS_BASE_URLL0 API 端点
OCEANBUS_API_KEY你的 API 密钥
OCEANBUS_AGENT_ID你的 Agent ID

不适用场景

  • 你只需要让大模型访问本地工具/资源——原生 MCP 就足够了
  • 你的所有 Agent 都在同一进程中运行,并直接调用函数
  • 你构建的系统不需要考虑信任和身份问题

获取帮助


隐私

  • 绝不会记录或向第三方传输任何消息内容
  • 不会记录任何 OpenID
  • 仅追踪工具调用的次数(例如,“send_message 被调用了 42 次”)
  • 每日匿名汇总数据会通过 OceanBus 加密消息发送,用于生态分析
  • 遵循 OceanBus Constitution — 最短保留期限

相关项目

项目说明
oceanbus核心 SDK — npm install oceanbus
oceanbus-langchainLangChain / CrewAI 集成
Ocean Chat入门灯塔 — P2P 消息,5 分钟跑通
Captain Lobster进阶灯塔 — Zero-Player AI 交易游戏
Guess AI高阶灯塔 — 多人社交推理游戏
Ocean Agent保险代理人 AI 工作台
平台集成
Dify 插件Dify 平台 OceanBus 插件
Coze 插件Coze 平台(已上架)
百炼接入阿里云百炼 MCP 接入
MCP Registry官方 MCP 注册表
ClawHub 集合更多 OceanBus 技能

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。