SuperSocket.Primitives 2.1.0

Release Note: SuperSocket 2.1.0

Overview

SuperSocket 2.1.0 is a significant update that introduces groundbreaking Model Context Protocol (MCP) support, advanced HTTP capabilities with Keep-Alive and Server-Sent Events (SSE), and .NET 10 compatibility. This release expands SuperSocket's use cases into AI agent communication, real-time web applications, and modern cloud-native scenarios while enhancing client flexibility and multi-server hosting capabilities.

Major Features

Model Context Protocol (MCP) Support

SuperSocket now provides comprehensive support for the Model Context Protocol (MCP), enabling seamless integration with AI agents and language models.

Core MCP Features

• Full MCP specification compliance for AI agent communication
• Multiple transport options: TCP, HTTP, WebSocket, and stdio
• Native command system integration for MCP request handling
• JSON-RPC 2.0 protocol support with type-safe message handling
• Resource, tool, and prompt management capabilities

MCP Transport Implementations

• TCP/WebSocket MCP Server: Traditional socket-based MCP communication
• HTTP MCP Server: RESTful MCP with POST request handling and SSE notifications
• Stdio MCP Server: Standard input/output for local process communication
• Shared command infrastructure: Unified handler registry across all transports

Sample Projects

Four comprehensive MCP samples demonstrating different use cases:

• McpServer: Basic TCP/WebSocket MCP server
• McpHttpServer: HTTP-based MCP with SSE support
• McpStdioServer: Standard I/O MCP for local agents
• McpWebSocketServer: Dedicated WebSocket MCP implementation

HTTP Keep-Alive and Server-Sent Events (SSE)

Enhanced HTTP capabilities for building modern web applications and real-time communication.

HTTP Keep-Alive Support

• Persistent connection management for improved performance
• Configurable keep-alive timeouts and connection limits
• HTTP/1.1 compliant connection reuse
• Automatic connection cleanup and lifecycle management

Server-Sent Events (SSE)

• Full SSE specification support (text/event-stream)
• Event streaming capabilities with named events
• Heartbeat and reconnection support for reliable delivery
• SSE-specific session management and encoding
• Integration with MCP for real-time AI agent notifications

Configuration Options

• KeepAlive property for enabling/disabling persistent connections
• Timeout and heartbeat configuration
• Custom event encoding and formatting

.NET 10 Support

• Added .NET 10.0 target framework across all projects
• Forward compatibility with the latest .NET runtime
• Removed legacy mobile targets (net8.0-ios, net8.0-android, net8.0-macos, net8.0-tvos)
• Updated SDK version to 9.0.0 for build infrastructure

API Enhancements

Socket Client Improvements

Enhanced SocketConnector Extensibility

• Exposed LocalEndPoint property for client-side endpoint binding
• NoDelay enabled by default for improved low-latency scenarios
• Virtual ConfigureSocket method for custom socket configuration
• Better support for source IP binding and socket option customization

Improved Client Flexibility

• Enhanced constructor options for endpoint binding
• Better extensibility through virtual methods
• Improved documentation and XML comments

Multiple Server Setup Optimization

• Streamlined API for hosting multiple server instances
• Support for multiple instances of the same server type
• Automatic server configuration loading from serverOptions by name
• Improved flexibility in multi-server scenarios

Command System Enhancements

• Public IWebSocketCommandMiddleware interface for custom middleware
• Inherited filter support for commands from base classes
• Better command pipeline integration with WebSocket messages
• Connection token propagation for cancellation scenarios

Bug Fixes and Improvements

Stability Improvements

• Fixed unit test stability issues in TestMultipleServerHost
• Resolved SSE test data reading strategy issues
• Fixed HTTP Keep-Alive test hanging problems with proper timeout handling
• Improved connection cleanup when KeepAlive=false

Build and Compatibility

• Fixed .NET 8.0 compatibility issues in unit test projects
• Restored .NET 9.0 target framework support across projects
• Fixed build warnings (xUnit1051) in test classes
• Updated sample projects with correct target frameworks

Documentation

• Enhanced XML documentation throughout the codebase
• Added comprehensive README files for MCP samples
• Updated main README with MCP and SSE features
• Improved code comments for better IntelliSense experience

Breaking Changes

None - This release maintains full backward compatibility with v2.0.2

Migration Guide

No migration steps required. Upgrading from v2.0.2 to v2.1.0 is seamless.

To Use New MCP Features

1. Add reference to SuperSocket.MCP package
2. Choose your transport (TCP, HTTP, WebSocket, or stdio)
3. Implement MCP command handlers using SuperSocket's command framework
4. Configure MCP server with appropriate options

To Use HTTP Keep-Alive/SSE

1. Set KeepAlive = true in HTTP request/response handling
2. For SSE: Use SseSessionExtensions for event streaming
3. Configure heartbeat and timeout options as needed

To Use Enhanced Socket Client

// Bind to specific local endpoint
var connector = new SocketConnector(new IPEndPoint(IPAddress.Any, 0));

// Or customize socket configuration
public class CustomConnector : SocketConnector
{
    protected override void ConfigureSocket(Socket socket)
    {
        base.ConfigureSocket(socket);
        // Add custom socket options
    }
}

NuGet Packages Updated

All SuperSocket 2.1.0 packages are available on NuGet:

• SuperSocket
• SuperSocket.Client
• SuperSocket.Client.Proxy
• SuperSocket.ProtoBase
• SuperSocket.Server
• SuperSocket.Server.Abstractions
• SuperSocket.WebSocket
• SuperSocket.WebSocket.Server
• SuperSocket.Command
• SuperSocket.Udp
• SuperSocket.Kestrel
• NEW: SuperSocket.MCP
• NEW: SuperSocket.Http

What's Next

Future releases will continue to enhance MCP capabilities, add more protocol support, and improve performance. Stay tuned for:

• Enhanced MCP resource and tool management
• Additional transport protocol options
• Performance optimizations for high-throughput scenarios
• Extended HTTP/2 and HTTP/3 support

Acknowledgments

Special thanks to all contributors who made this release possible, especially:

• AI-assisted development with GitHub Copilot
• Community feedback and bug reports
• Testing and validation efforts

Resources

• GitHub Repository
• Documentation
• MCP Specification
• Sample Projects

Released: April 2026