# 🚀 MCP Firebird v2.5.1 - Smithery Platform Support
**Release Date:** January 22, 2025
**Status:** Stable Release
**Previous Version:** 2.5.0
---
## 🎉 Overview
Version 2.5.1 brings **official Smithery platform support** and enhanced **wire encryption capabilities**, making MCP Firebird even more accessible and secure. This release focuses on cloud deployment flexibility and enterprise-grade security features.
---
## ✨ Major Features
### 🌐 Smithery Platform Integration
**One-Click Cloud Deployment**
- ✅ **Official Smithery support** - Deploy MCP Firebird to the cloud in minutes
- ✅ **Automatic configuration** - Smithery detects and configures everything automatically
- ✅ **Web-based management** - Manage your server through Smithery's intuitive dashboard
- ✅ **Instant scaling** - Scale your deployment as needed
- ✅ **Zero infrastructure management** - No servers to maintain
**How to Deploy on Smithery:**
1. Visit [smithery.ai](https://smithery.ai)
2. Connect your GitHub account
3. Select the `mcpFirebird` repository
4. Configure your Firebird database connection
5. Click Deploy - Done! ✨
**Smithery Benefits:**
- 🚀 Deploy in under 5 minutes
- 🌍 Global CDN for low latency
- 🔄 Automatic updates and rollbacks
- 📊 Built-in monitoring and logs
- 🔐 Secure credential management
- 💰 Pay-as-you-go pricing
### 🔒 Enhanced Wire Encryption Support
**Enterprise-Grade Security**
This release significantly improves wire encryption capabilities for Firebird 3.0+ databases:
- ✅ **Full WireCrypt compatibility** - Works seamlessly with `WireCrypt = Required` servers
- ✅ **Native driver integration** - Automatic detection and fallback
- ✅ **Zero configuration** - Just set `USE_NATIVE_DRIVER=true`
- ✅ **Production tested** - Verified with enterprise Firebird deployments
- ✅ **Encryption verification** - Built-in checks to ensure encryption is active
**Why Wire Encryption Matters:**
🔐 **Protects sensitive data** in transit between client and server
🔐 **Compliance ready** - Meets security requirements for regulated industries
🔐 **Zero performance impact** - Modern encryption is hardware-accelerated
🔐 **Industry standard** - AES-256 encryption for all database traffic
**Configuration:**
```bash
# Enable wire encryption (Smithery)
useNativeDriver: true
# Enable wire encryption (Docker/NPX)
USE_NATIVE_DRIVER=true
```
**Supported Scenarios:**
- ✅ Firebird 3.0+ with WireCrypt = Enabled
- ✅ Firebird 3.0+ with WireCrypt = Required
- ✅ Firebird 4.0+ with enhanced encryption
- ✅ Cloud-hosted Firebird databases
- ✅ On-premise secure deployments
### 📚 Comprehensive Smithery Documentation
**New Documentation:**
- 📖 `docs/smithery-deployment.md` - Complete Smithery deployment guide
- Step-by-step deployment instructions
- Configuration examples
- Troubleshooting guide
- Security best practices
- Performance optimization tips
**Updated README:**
- ✅ Smithery installation section
- ✅ Quick start with Smithery
- ✅ Configuration examples
- ✅ Deployment comparison table
---
## 🆕 New Features
### Smithery-Specific Features
1. **HTTP/Streamable Transport**
- Optimized for web-based clients
- Compatible with Smithery's infrastructure
- Automatic CORS configuration
- Query parameter configuration support
2. **Configuration Schema**
- JSON Schema validation
- Auto-generated UI in Smithery dashboard
- Type-safe configuration
- Default values for quick setup
3. **Health Monitoring**
- `/health` endpoint for monitoring
- Uptime tracking
- Memory usage reporting
- Version information
### Enhanced Documentation
- Complete Smithery deployment guide
- Wire encryption setup instructions
- Security best practices
- Performance tuning guide
- Troubleshooting section
---
## 🔧 Technical Improvements
### Smithery Integration
**Entry Points:**
- `src/smithery-entry.ts` - Smithery-specific entry point
- `src/http-entry.ts` - HTTP/Streamable transport
- Modern MCP SDK v1.13.2+ APIs
**Configuration:**
- `smithery.yaml` - Smithery deployment configuration
- `smithery.config.js` - Build configuration
- Automatic environment variable parsing
### Wire Encryption
**Driver Support:**
- Automatic native driver detection
- Graceful fallback to pure JavaScript driver
- Connection validation
- Encryption status verification
---
## 🔄 Breaking Changes
### None! 🎉
Version 2.5.1 is **fully backward compatible** with 2.5.0:
- ✅ All existing configurations work unchanged
- ✅ Same CLI arguments and environment variables
- ✅ Same MCP protocol implementation
- ✅ Same tool and prompt APIs
- ✅ Existing deployments continue to work
---
## 📦 Deployment Options
### Option 1: Smithery (NEW! ⭐)
**Easiest deployment method:**
```bash
# 1. Visit smithery.ai
# 2. Connect GitHub
# 3. Select mcpFirebird repository
# 4. Configure database connection
# 5. Deploy!
```
**Configuration in Smithery:**
```yaml
host: "your-firebird-server.com"
port: 3050
database: "/path/to/database.fdb"
user: "SYSDBA"
password: "your-secure-password"
useNativeDriver: true # Enable wire encryption
logLevel: "info"
```
### Option 2: Docker
```bash
docker run -d -p 3003:3003 \
-e FIREBIRD_HOST=your-host \
-e FIREBIRD_DATABASE=/path/to/db.fdb \
-e USE_NATIVE_DRIVER=true \
mcp-firebird:2.5.1
```
### Option 3: NPX/NPM
```bash
npm install -g mcp-firebird@latest
mcp-firebird \
--host localhost \
--database /path/to/db.fdb \
--use-native-driver
```
### Option 4: Claude Desktop
```json
{
"mcpServers": {
"firebird": {
"command": "npx",
"args": [
"mcp-firebird@latest",
"--database", "/path/to/db.fdb",
"--use-native-driver"
]
}
}
}
```
---
## 📊 Deployment Comparison
| Feature | Smithery | Docker | NPX | Claude Desktop |
|---------|----------|--------|-----|----------------|
| **Setup Time** | 5 min | 10 min | 2 min | 2 min |
| **Cloud Hosted** | ✅ Yes | Optional | ❌ No | ❌ No |
| **Auto Updates** | ✅ Yes | Manual | Manual | Manual |
| **Monitoring** | ✅ Built-in | External | ❌ No | ❌ No |
| **Scaling** | ✅ Auto | Manual | ❌ No | ❌ No |
| **Cost** | Pay-as-go | Infrastructure | Free | Free |
| **Best For** | Production | Production | Development | AI Clients |
---
## 🔐 Security Enhancements
### Wire Encryption
- **AES-256 encryption** for all database traffic
- **Automatic encryption verification**
- **Compatible with Firebird 3.0+ WireCrypt**
- **Zero configuration** (just enable native driver)
### Smithery Security
- **Secure credential storage** in Smithery vault
- **Environment variable encryption**
- **HTTPS-only connections**
- **Automatic security updates**
---
## 🐛 Bug Fixes
- Fixed Smithery deployment configuration
- Improved wire encryption detection
- Enhanced error messages for connection issues
- Fixed TypeScript type issues in HTTP entry points
- Improved resource handler signatures
---
## 📈 Migration Guide
### From v2.5.0 to v2.5.1
**No changes required!** Simply update:
```bash
# NPM
npm install -g mcp-firebird@latest
# Docker
docker pull mcp-firebird:2.5.1
# Smithery
# Automatic update on next deployment
```
### Enabling Wire Encryption
If you're using Firebird 3.0+ with WireCrypt:
```bash
# Add this to your configuration
USE_NATIVE_DRIVER=true
# Or in Smithery
useNativeDriver: true
```
---
## 💬 Support & Resources
- **Smithery Deployment Guide:** [docs/smithery-deployment.md](./docs/smithery-deployment.md)
- **General Deployment Guide:** [DEPLOYMENT.md](./DEPLOYMENT.md)
- **GitHub Issues:** [Report bugs or request features](https://github.com/PuroDelphi/mcpFirebird/issues)
- **Donations:** Support development via [PayPal](https://www.paypal.com/donate/?hosted_button_id=KBAUBYYDNHQNQ)
- **Professional Support:** Hire AI agents at [asistentesautonomos.com](https://asistentesautonomos.com)
---
## 🗺️ What's Next
### Coming in v2.6.0
- Modern MCP SDK v1.13.2+ APIs
- Enhanced capabilities declaration
- Improved type safety
- Performance optimizations
- Extended monitoring
---
## 📝 Changelog
### Added
- ✅ Official Smithery platform support
- ✅ `docs/smithery-deployment.md` comprehensive guide
- ✅ `smithery.yaml` deployment configuration
- ✅ `smithery.config.js` build configuration
- ✅ HTTP/Streamable transport entry points
- ✅ Enhanced wire encryption documentation
- ✅ Health monitoring endpoints
- ✅ Configuration schema validation
### Improved
- 🔒 Wire encryption detection and validation
- 📚 Documentation for Smithery deployment
- 🔧 Configuration handling
- 🐛 Error messages and logging
- ⚡ HTTP transport performance
### Fixed
- TypeScript compilation in Smithery environment
- Resource handler type signatures
- Prompt handler role types
- Configuration schema format
---
## 🎯 Quick Start with Smithery
```bash
# 1. Visit Smithery
https://smithery.ai
# 2. Deploy MCP Firebird
- Connect GitHub
- Select mcpFirebird repository
- Configure database connection
- Enable wire encryption (optional)
- Deploy!
# 3. Use in your AI application
const transport = new StreamableHTTPClientTransport(
"https://server.smithery.ai/your-username/mcp-firebird"
);
```
---
**Full Changelog:** [v2.5.0...v2.5.1](https://github.com/PuroDelphi/mcpFirebird/compare/v2.5.0...v2.5.1)
**Download:** [Release v2.5.1](https://github.com/PuroDelphi/mcpFirebird/releases/tag/v2.5.1)
---
*Made with ❤️ by [Jhonny Suárez](https://asistentesautonomos.com)*
