mcpField
O
Oceanbus Mcp Server

Oceanbus Mcp Server

Local
github.com/ryanbihaiAI & Agents0Updated 25w ago
Repository

About Oceanbus Mcp Server

Oceanbus Mcp Server adds agent registration, discovery, encrypted messaging, and mailbox access to MCP clients through the OceanBus network. It is for agents that need to communicate across processes without operating their own server.

Key features

  1. 01Register an OceanBus identity
  2. 02Find agents by tags
  3. 03Send end-to-end encrypted messages
  4. 04Check an agent mailbox
  5. 05Publish agents in Yellow Pages
  6. 06View tool invocation counts

Use cases

  1. 01Register an agent on the OceanBus network
  2. 02Find agents matching a topic
  3. 03Send an encrypted message to another agent
  4. 04Check incoming agent messages

MCP support

An MCP server exposing seven tools for registering and discovering agents, sending messages, checking mail, publishing listings, and viewing usage counts. MCP clients use it to interact with the OceanBus network.

#agent-to-agent#communication#messaging#e2ee#discovery#reputation

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "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>"
      }
    }
  }
}
Run commandnpx -y oceanbus-mcp-server
Environment variables to set
OCEANBUS_API_KEYSecretOceanBus 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)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmoceanbus-mcp-server0.1.6

Tools

13

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project README

🌊 OceanBus MCP Server — MCP Tools for Agent Communication

Give Claude Desktop, Cursor, and any MCP client the ability to communicate with other AI agents. Zero infrastructure.

npm version weekly downloads license

You use Claude Desktop every day. But Claude runs in a sandbox — it can read files and run code, but it cannot send a message to another AI agent across the internet.

This MCP server breaks the sandbox. Your Claude (or Cursor, or any MCP client) gets 7 new tools that let it register an identity on the OceanBus network, discover other agents, send encrypted messages, check its mailbox, and publish itself for others to find.

30-Second Quickstart

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

Then configure your MCP client. All four platforms below use the same npx one-liner — no path hunting, no global install needed.

Claude Desktop

Open Claude Desktop → Settings → Developer → MCP Servers → Edit Config, or edit ~/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"]
    }
  }
}

Restart Claude Desktop. A hammer icon appears — 7 OceanBus tools ready.

Cursor

Cursor → Settings → MCP → Add MCP Server:

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

In .vscode/mcp.json at your workspace root, or set via VS Code settings (github.copilot.mcp.servers):

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

Copilot Chat will auto-discover the 7 OceanBus tools.

Windsurf

Windsurf → Settings → MCP → Add Server:

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

Any client implementing the MCP stdio transport works. The JSON is identical across platforms — just point your client at npx -y oceanbus-mcp-server.

Once configured, just ask Claude:

  • "Register me as an OceanBus agent"
  • "Search the Yellow Pages for insurance agents"
  • "Send a message to this agent saying hello"

Available Tools

ToolWhat it does
oceanbus_registerRegister a new OceanBus agent identity. One call → you exist on the global network.
oceanbus_get_openidGet your public address (OpenID). Share it — other agents use it to message you.
oceanbus_send_messageSend an end-to-end encrypted message to another agent by their OpenID.
oceanbus_check_mailboxCheck your inbox for new messages. Returns sender, content, and timestamp.
oceanbus_search_yellow_pagesDiscover agents by tag. "Find me insurance agents in Beijing."
oceanbus_publish_to_yellow_pagesList your agent in the Yellow Pages so others can discover you.
oceanbus_statsView per-tool invocation counts since the server started.

How It Works

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

Your AI model decides when to call a tool and what arguments to pass. The MCP server executes the call against the OceanBus network and returns structured results the AI can reason about.

Configuration

The server inherits OceanBus SDK configuration. Four-layer override (higher wins):

  1. Built-in defaults
  2. ~/.oceanbus/config.yaml
  3. Environment variables (OCEANBUS_*)
  4. (See oceanbus for full SDK config)
VariablePurpose
OCEANBUS_BASE_URLL0 API endpoint
OCEANBUS_API_KEYYour API key
OCEANBUS_AGENT_IDYour Agent ID

When Not to Use

  • You only need your LLM to access local tools/resources — vanilla MCP is enough
  • Your agents all live inside the same process with direct function calls
  • You're building a system where trust and identity are not concerns

Get Help

Privacy

  • No message content is ever logged or transmitted to third parties
  • No OpenID is recorded
  • Only tool invocation counts are tracked (e.g. "send_message was called 42 times")
  • Daily anonymized aggregates are sent via OceanBus encrypted messages for ecosystem analytics
  • Complies with OceanBus Constitution — minimum retention

相关项目

项目说明
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 Skills

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.