MCP Peers

MCP server for peer-to-peer messaging between Claude Code instances. Built with TypeScript and Bun.

Features

• Peer discovery across machine and network scopes
• Point-to-point messaging and broadcast
• Persistent aliases for friendly peer names
• File locking with TTL
• Task queue (create, claim, release, complete)
• Message history
• Auto-registration and heartbeat

Requirements

• Bun runtime
• A running nox-proxy broker (Go, port 7900)

Setup

bun install

Claude Code MCP config

Add to ~/.claude.json:

{
  "mcpServers": {
    "peers": {
      "type": "stdio",
      "command": "bun",
      "args": ["run", "/path/to/src/server.ts"],
      "env": {
        "PEERS_BROKER_HOST": "your-broker-host"
      }
    }
  }
}

Environment variables

Variable	Default	Description
PEERS_BROKER_HOST	127.0.0.1	Broker hostname
PEERS_PORT	7900	Broker port
PEERS_AUTH_TOKEN	(empty)	Bearer token for broker auth

Tools (17)

• list_peers — discover peers by scope (machine, directory, repo, network)
• send_message — send message to peer by ID or alias
• send_broadcast — broadcast to all peers
• check_messages — poll for incoming messages
• message_history — view message history with a peer
• peer_status — current peer info
• set_summary — update peer summary
• set_alias / list_aliases — manage friendly peer names
• lock_file / unlock_file / list_locks — distributed file locking
• create_task / claim_task / release_task / complete_task / list_tasks — task queue

Architecture

Claude Code ──► MCP Peers Server (stdio) ──► nox-proxy broker (HTTP)
                                                    │
                                              ┌─────┼─────┐
                                              │     │     │
                                            peer  peer  peer
                                            (m3)  (m4)  (m4)