Skip to content

v2.2.0 - Complete SSE Transport Implementation

Choose a tag to compare

View all tags
@PuroDelphi PuroDelphi released this 27 Jun 23:47
· 184 commits to main since this release
v2.2.0
43f6e94

🚀 MCP Firebird v2.2.0 - Complete SSE Transport Implementation

🎯 Major Release Highlights

This release brings complete SSE (Server-Sent Events) transport support to MCP Firebird, making it fully compatible with the MCP Inspector and modern MCP clients while maintaining 100% backwards compatibility with existing STDIO implementations.

✨ New Features

🌐 SSE Transport Support

  • Full SSE Implementation: Complete Server-Sent Events transport using official MCP SDK v1.13.2
  • MCP Inspector Compatible: Works seamlessly with npx @modelcontextprotocol/inspector
  • Backwards Compatible Server: Supports both modern and legacy MCP clients
  • Multi-Protocol Support: Single server instance handles STDIO, SSE, and HTTP simultaneously

🔧 Technical Improvements

  • Latest MCP SDK: Updated to Model Context Protocol TypeScript SDK v1.13.2
  • Modern API Implementation: Using official registerTool(), registerPrompt() methods
  • Enhanced Session Management: Robust HTTP session handling with automatic cleanup
  • Windows Path Support: Proper escaping and handling of Windows file paths with backslashes

🌐 New HTTP Endpoints

  • Modern Streamable HTTP: POST/GET/DELETE /mcp for latest MCP clients
  • Legacy SSE: GET /sse for backwards compatibility with older clients
  • Legacy Messages: POST /messages for complete client support

🛠️ Usage Examples

SSE Transport (New!)

# Start SSE server
npx mcp-firebird@latest --transport-type sse --sse-port 3003 \
  --database "C:\\Path\\To\\Database.FDB" \
  --user SYSDBA --password masterkey

# Connect MCP Inspector via SSE
npx @modelcontextprotocol/inspector http://localhost:3003/sse

STDIO Transport (Preserved)

# Traditional STDIO (unchanged)
npx @modelcontextprotocol/inspector \
  npx mcp-firebird@latest --transport-type stdio \
  --database "C:\\Path\\To\\Database.FDB" \
  --user SYSDBA --password masterkey

🔒 Stability & Compatibility

✅ Backwards Compatibility

  • STDIO Preserved: All existing STDIO functionality maintained without changes
  • No Breaking Changes: Existing configurations continue to work
  • Same CLI Interface: Familiar command-line arguments and options

🏗️ Production Ready

  • Thoroughly Tested: Verified with real Firebird databases
  • Stable Connections: No ECONNRESET errors in SSE transport
  • Cross-Platform: Enhanced Windows and Linux compatibility
  • Error Handling: Comprehensive error recovery and logging

📊 What's New

  • 16 Database Tools: Complete set of Firebird database operations
  • 10 Prompts: 5 database + 5 SQL analysis prompts
  • Multi-Transport: STDIO, SSE, and HTTP in single package
  • MCP Inspector: Full compatibility with official inspector
  • Windows Support: Proper file path handling for Windows users

🎯 Migration Guide

For Existing Users

No migration required! Your existing STDIO configurations will continue to work exactly as before.

To Use SSE Transport

Simply add the transport type parameter:

# Add these parameters to your existing command
--transport-type sse --sse-port 3003

Full Changelog: v2.1.0...v2.2.0

Assets 2
Loading