tunnel mcp — Directly connect Claude agents with an…

Pitch

Description

Comments

About this project

tunnel-mcp streamlines collaboration between developers by allowing their Claude agents to communicate directly through a secure, ephemeral tunnel. This eliminates the need for manual message forwarding, enabling seamless and efficient interactions while ensuring control over data security.

tunnel-mcp is a specialized tool designed to facilitate direct communication between two developers' Claude agents through an ephemeral, end-to-end encrypted tunnel. This server empowers agents to interact without the need for human intervention, thereby streamlining the collaborative process in software development.

Key Features

Direct Communication: Enable Claude agents to communicate directly without manual message relay, eliminating the inefficient human copy-paste process.
End-to-End Encryption: All messages exchanged between agents are secured with robust encryption, ensuring privacy and confidentiality.
Instant Setup: Initiate a tunnel with minimal effort; simply run a command to open a secure connection in under 30 seconds.
Single-Use Join Link: Generate a one-time link for joining a session, enhancing security by making it valid for only one use and expiring after approximately ten minutes.

How It Works

With tunnel-mcp, the process is simplified into two straightforward steps:

Host Setup: The host developer executes tunnel_open, which sets up a relay via Cloudflare's Quick Tunnel. This removes the need for server provisioning or port forwarding.
```
tunnel_open({ goal })
```
Guest Connection: The guest developer uses the provided join link to connect directly to the host's tunnel. Upon joining, both agents can freely exchange messages.
```
tunnel_join({ joinLink })
```

The communication between the agents is facilitated through commands such as tunnel_say to send messages and tunnel_listen to receive responses. Each session is controlled, with clear termination processes to ensure efficient resource management.

Security Model

tunnel-mcp prioritizes security with a comprehensive model that includes:

End-to-end encryption for all message content.
A one-time join link embedded with the session key, limiting exposure and access.
An enforced lock preventing more than two participants from joining a session, ensuring a controlled environment.

Requirements

Node.js version 20 or higher
A compatible Claude MCP client
cloudflared, which is automatically installed if not already present in the system path.

Quickstart Example

To quickly set up a communication session:

Host opens a tunnel:

"Open a tunnel to collaborate on a feature."
Share the generated invite link securely.
Guest joins using the provided link:

"Join this tunnel: <link>"

This efficient mechanism fosters collaboration by allowing two AI agents to focus on their tasks while maintaining human oversight over sensitive operations.

For more details, check the GitHub repository to explore installation, extended features, and troubleshooting tips.