Skip to content

v2.2.1 - Stable Release with Full SSE Support

Choose a tag to compare

View all tags
@PuroDelphi PuroDelphi released this 29 Jun 17:36
· 179 commits to main since this release
v2.2.1
27e4c57

🎉 MCP Firebird v2.2.1 - Stable Release

🔄 Critical Fix Release

This release addresses the critical issue where the stable version (v2.2.0) was not working correctly while the alpha version was functional. v2.2.1 now has the same functionality as the working alpha version.

✅ What's Fixed

🚨 Main Issue Resolved:

  • Problem: mcp-firebird@latest (v2.2.0) was broken while mcp-firebird@alpha worked correctly
  • Solution: Synchronized main branch with alpha branch functionality
  • Result: Both stable and alpha versions now work identically

🔧 Functional Improvements Included:

  • ✅ Complete SSE Transport: Full Server-Sent Events implementation
  • ✅ Streamable HTTP Support: Modern HTTP streaming capabilities
  • ✅ Session Management: Enhanced connection handling
  • ✅ MCP SDK Compatibility: Updated to latest MCP SDK standards
  • ✅ Windows File Path Handling: Proper backslash escaping for Windows paths
  • ✅ Backwards Compatibility: STDIO transport preserved and working

📊 Version Status

Version Status Functionality
v2.2.0 ❌ Broken Limited functionality
v2.2.1 ✅ Working Full functionality
v2.2.0-alpha.4 ✅ Working Full functionality

🚀 Usage Examples

NPX Commands (Recommended)

STDIO Mode (Claude Desktop):

npx mcp-firebird --transport-type stdio \
  --database "F:\\Proyectos\\SAI\\AUTOSERVICIO_LA_PAZ.FDB" \
  --user SYSDBA --password masterkey

SSE Mode (MCP Inspector):

npx mcp-firebird --transport-type sse --sse-port 3003 \
  --database "F:\\Proyectos\\SAI\\AUTOSERVICIO_LA_PAZ.FDB" \
  --user SYSDBA --password masterkey

Claude Desktop Configuration:

{
  "mcpServers": {
    "firebird": {
      "command": "npx",
      "args": [
        "mcp-firebird@latest",
        "--transport-type", "stdio",
        "--database", "F:\\Proyectos\\SAI\\AUTOSERVICIO_LA_PAZ.FDB",
        "--user", "SYSDBA",
        "--password", "masterkey"
      ]
    }
  }
}

🎯 Key Features

  • 16 Database Tools: Complete Firebird database operations
  • 10 Smart Prompts: SQL analysis and optimization helpers
  • Dual Transport: Both STDIO and SSE protocols supported
  • Windows Compatible: Proper file path handling
  • Production Ready: Tested and stable

🔧 Technical Details

Supported Transports:

  • ✅ STDIO: For Claude Desktop integration
  • ✅ SSE: For MCP Inspector and web clients
  • ✅ HTTP Streaming: Modern streamable HTTP support

Database Operations:

  • Execute SQL queries with parameters
  • List and describe tables
  • Analyze table relationships
  • Performance analysis tools
  • Batch operations support
  • Database backup and validation

📈 Migration from v2.2.0

No changes required! Simply update your installation:

# Update global installation
npm install -g mcp-firebird@latest

# Or use npx (always gets latest)
npx mcp-firebird@latest --version

🙏 Support the Project

If this project helps you, consider supporting its development:

PayPal

📞 Need Help?

  • 📖 Documentation: Check the README and docs/ folder
  • 🐛 Issues: Report bugs on GitHub Issues
  • 💬 Discussions: Join GitHub Discussions
  • 🎥 Video Example: See examples/ExampleClaudeV2.mp4

Full Changelog: v2.2.0...v2.2.1

Assets 2
Loading