Skip to content

Conversation

@cotdp
Copy link
Contributor

@cotdp cotdp commented Sep 22, 2025

When running multiple Claude Code instances with numerous subagents on a single machine, the STDIO MCP overhead becomes a significant bottleneck. This PR introduces Server-Sent Events (SSE) transport as the preferred alternative when available, dramatically improving resource utilization in multi-agent scenarios.

You can run one shared instance through Docker and have multiple sessions/agents share it.

Key Performance Benefits

  • Eliminates STDIO contention: Multiple sessions can connect simultaneously without process blocking
  • Reduces resource overhead: Shared server instance vs. per-connection process spawning
  • Better agent density: Supports concurrent connections with individual server instances

Implementation Details

  • Add Server-Sent Events (SSE) transport for multi-client connections
  • Implement dual transport support (stdio + SSE simultaneously)
  • Add Docker Compose configuration with health checks
  • Use branded port 7423 (SHADCN on phone keypad)
  • Support concurrent connections with individual server instances
  • Add comprehensive documentation and examples
  • Include nginx reverse proxy configuration
  • Update CLI with transport mode options and environment variables
  • Maintain backwards compatibility with existing stdio mode

- Add Server-Sent Events (SSE) transport for multi-client connections
- Implement dual transport support (stdio + SSE simultaneously)
- Add Docker Compose configuration with health checks
- Use branded port 7423 (SHADCN on phone keypad)
- Support concurrent connections with individual server instances
- Add comprehensive documentation and examples
- Include nginx reverse proxy configuration
- Update CLI with transport mode options and environment variables
- Maintain backwards compatibility with existing stdio mode

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the pr,it's now under review

@Jpisnice Jpisnice merged commit ee78d3f into Jpisnice:master Oct 23, 2025
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants