mesh-mcp-bridge 0.1.0

Bidirectional bridge between MCP servers and the mesh network

mesh-mcp-bridge

Bidirectional bridge between MCP servers and the MARS protocol network. It publishes MCP server capabilities as mesh descriptors and exposes mesh capabilities to MCP-compatible agents as standard MCP tools.

Install

pip install mesh-mcp-bridge

Live Network

Connect your gateway to any MARS hub:

Hub	Address	Location
us-east	5.161.53.251:4433	Ashburn, VA
us-west	5.78.197.92:4433	Hillsboro, OR
eu-central	46.225.55.16:4433	Nuremberg, DE
ap-southeast	5.223.69.128:4433	Singapore

# Start a gateway connected to the live mesh
./target/release/mesh-gateway --seed 5.161.53.251:4433 --listen 0.0.0.0:3000

Usage

Publish MCP server tools to the mesh

mesh-mcp-bridge publish \
  --gateway http://localhost:3000 \
  --mcp-server "python my_mcp_server.py" \
  --name "my-tools"

This connects to the MCP server, lists its tools, and registers each one as a mesh descriptor (type mcp/tool/{tool_name}).

Discover mesh capabilities via MCP

mesh-mcp-bridge serve \
  --gateway http://localhost:3000 \
  --transport stdio

Or over HTTP:

mesh-mcp-bridge serve \
  --gateway http://localhost:3000 \
  --transport http \
  --port 8080

Any MCP-compatible agent can then connect to this server and see all mcp/tool/* descriptors on the mesh as standard MCP tools.

Architecture

┌──────────────┐         ┌──────────────────┐         ┌──────────────┐
│  MCP Server  │◄───────►│  mesh-mcp-bridge │◄───────►│ Mesh Gateway │
│  (tools)     │  stdio  │                  │  HTTP   │  /v1/publish │
└──────────────┘         │  publish mode:   │         │  /v1/discover│
                         │  MCP → mesh      │         └──────┬───────┘
                         │                  │                │
                         │  serve mode:     │                ▼
┌──────────────┐         │  mesh → MCP      │         ┌──────────────┐
│  MCP Client  │◄───────►│                  │         │  Mesh DHT    │
│  (agent)     │ stdio/  └──────────────────┘         │  Network     │
└──────────────┘  HTTP                                └──────────────┘

Publish mode — scans an MCP server's tool listing and registers each tool as a mesh descriptor so any mesh participant can discover it.

Serve mode — queries the mesh for mcp/tool/* descriptors and presents them as MCP tools. When an agent invokes a tool the bridge forwards the call to the endpoint recorded in the descriptor.

Links

• mars-protocol
• Model Context Protocol
• MCP Python SDK