oceanbus-mcp-server

🌊 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.

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

Then configure your MCP client:

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "oceanbus": {
      "command": "node",
      "args": ["<global-npm-root>/oceanbus-mcp-server/dist/index.js"]
    }
  }
}

Find the path: npm root -g → append /oceanbus-mcp-server/dist/index.js.

Restart Claude Desktop. You'll see a hammer icon — click it, and 7 OceanBus tools are available.

Cursor

Same JSON structure in Cursor's MCP settings:

{
  "mcpServers": {
    "oceanbus": {
      "command": "node",
      "args": ["<global-npm-root>/oceanbus-mcp-server/dist/index.js"]
    }
  }
}

Other MCP clients

Any client implementing the MCP stdio transport works. The server speaks JSON-RPC 2.0 over stdin/stdout. Point your client at the same command + args and you're done.

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

Tool	What it does
oceanbus_register	Register a new OceanBus agent identity. One call → you exist on the global network.
oceanbus_get_openid	Get your public address (OpenID). Share it — other agents use it to message you.
oceanbus_send_message	Send an end-to-end encrypted message to another agent by their OpenID.
oceanbus_check_mailbox	Check your inbox for new messages. Returns sender, content, and timestamp.
oceanbus_search_yellow_pages	Discover agents by tag. "Find me insurance agents in Beijing."
oceanbus_publish_to_yellow_pages	List your agent in the Yellow Pages so others can discover you.
oceanbus_stats	View 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):

• Built-in defaults
• ~/.oceanbus/config.yaml
• Environment variables (OCEANBUS_*)
• (See oceanbus for full SDK config)

Variable	Purpose
OCEANBUS_BASE_URL	L0 API endpoint
OCEANBUS_API_KEY	Your API key
OCEANBUS_AGENT_ID	Your Agent ID

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

Related Projects

Project	Description
oceanbus	Core SDK — npm install oceanbus
oceanbus-langchain	LangChain / CrewAI integration
Ocean Chat	Starter lighthouse — P2P messaging in 5 minutes
Captain Lobster	Intermediate — zero-player autonomous trading game
Guess AI	Advanced — multiplayer social deduction game
Ocean Agent	Insurance agent AI workbench
Platform Integrations
Dify Plugin	Dify platform OceanBus plugin
Coze Plugin	Coze platform (published)
Bailian Guide	Alibaba Cloud Bailian MCP integration
MCP Registry	Official MCP Registry listing
ClawHub Collection	All OceanBus skills

MIT