# Deploying MCP Servers to Hostinger
## 🚀 Hostinger Deployment Guide
This guide will help you deploy your MCP servers to Hostinger's VPS or shared hosting.
## 📋 Prerequisites
- Hostinger account with VPS or Business hosting plan
- Node.js support (VPS recommended)
- SSH access (for VPS)
- Domain name (optional)
---
## 🎯 Deployment Options
### Option 1: VPS Hosting (Recommended)
- Full control over server
- Can run multiple Node.js applications
- SSH access for easy deployment
- Better performance
### Option 2: Shared Hosting
- Limited Node.js support
- May require specific configurations
- Check Hostinger's Node.js hosting features
---
## 🛠️ VPS Deployment (Recommended)
### Step 1: Prepare Your Local Project
First, let's create production-ready configurations:
```bash
# In your project directory
npm run build
```
### Step 2: Upload Files to Hostinger
#### Method A: Using SCP/SFTP
```bash
# Upload your project folder
scp -r /Users/robertjhuff/Documents/Projects/MCPAddIn username@your-server-ip:/home/username/
# Or use SFTP
sftp username@your-server-ip
put -r /Users/robertjhuff/Documents/Projects/MCPAddIn
```
#### Method B: Using Git (if you have a repository)
```bash
# On your server
git clone https://github.com/yourusername/MCPAddIn.git
cd MCPAddIn
```
### Step 3: Install Dependencies on Server
```bash
# SSH into your server
ssh username@your-server-ip
# Navigate to project
cd MCPAddIn
# Install Node.js dependencies
npm install --production
# Build TypeScript
npm run build
```
### Step 4: Set Up Environment Variables
```bash
# Create .env file
nano .env
# Add your API keys
ALPHA_VANTAGE_API_KEY=your_alpha_vantage_key_here
EXCHANGE_RATE_API_KEY=your_exchange_rate_key_here
NODE_ENV=production
```
### Step 5: Install PM2 for Process Management
```bash
# Install PM2 globally
npm install -g pm2
# Create PM2 ecosystem file
nano ecosystem.config.js
```
### Step 6: Configure PM2
Create `ecosystem.config.js`:
```javascript
module.exports = {
apps: [
{
name: 'stock-mcp',
script: './dist/server.js',
port: 3000,
env: {
NODE_ENV: 'production',
PORT: 3000
}
},
{
name: 'currency-mcp',
script: './dist/currency-server.js',
port: 3001,
env: {
NODE_ENV: 'production',
PORT: 3001
}
},
{
name: 'time-mcp',
script: './dist/time-server.js',
port: 3002,
env: {
NODE_ENV: 'production',
PORT: 3002
}
},
{
name: 'units-mcp',
script: './dist/units-server.js',
port: 3003,
env: {
NODE_ENV: 'production',
PORT: 3003
}
}
]
};
```
### Step 7: Start Services with PM2
```bash
# Start all services
pm2 start ecosystem.config.js
# Save PM2 configuration
pm2 save
# Set up PM2 to start on boot
pm2 startup
```
### Step 8: Configure Nginx (Reverse Proxy)
```bash
# Install Nginx
sudo apt update
sudo apt install nginx
# Create Nginx configuration
sudo nano /etc/nginx/sites-available/mcp-servers
```
Add this configuration:
```nginx
server {
listen 80;
server_name your-domain.com;
# Stock Market MCP
location /stock/ {
proxy_pass http://localhost:3000/;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cache_bypass $http_upgrade;
}
# Currency MCP
location /currency/ {
proxy_pass http://localhost:3001/;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cache_bypass $http_upgrade;
}
# Time MCP
location /time/ {
proxy_pass http://localhost:3002/;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cache_bypass $http_upgrade;
}
# Units MCP
location /units/ {
proxy_pass http://localhost:3003/;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cache_bypass $http_upgrade;
}
}
```
Enable the site:
```bash
# Enable the site
sudo ln -s /etc/nginx/sites-available/mcp-servers /etc/nginx/sites-enabled/
# Test Nginx configuration
sudo nginx -t
# Restart Nginx
sudo systemctl restart nginx
```
### Step 9: Set Up SSL (Optional but Recommended)
```bash
# Install Certbot
sudo apt install certbot python3-certbot-nginx
# Get SSL certificate
sudo certbot --nginx -d your-domain.com
# Auto-renewal
sudo crontab -e
# Add: 0 12 * * * /usr/bin/certbot renew --quiet
```
---
## 🌐 Shared Hosting Deployment
### Step 1: Check Hostinger's Node.js Support
1. Log into your Hostinger control panel
2. Check if Node.js is available in your hosting plan
3. Note the Node.js version and any limitations
### Step 2: Upload Files
1. Use Hostinger's File Manager or FTP
2. Upload your project to the `public_html` folder
3. Make sure `package.json` is in the root
### Step 3: Install Dependencies
```bash
# In Hostinger's terminal (if available)
npm install --production
npm run build
```
### Step 4: Configure Environment Variables
Create `.env` file in Hostinger's file manager:
```
ALPHA_VANTAGE_API_KEY=your_key_here
NODE_ENV=production
```
### Step 5: Start Services
```bash
# Start individual servers
node dist/server.js &
node dist/currency-server.js &
node dist/time-server.js &
node dist/units-server.js &
```
---
## 🔧 Production Optimizations
### 1. Environment Configuration
Create `config/production.js`:
```javascript
module.exports = {
// Stock Market MCP
stock: {
port: process.env.STOCK_PORT || 3000,
alphaVantageKey: process.env.ALPHA_VANTAGE_API_KEY,
rateLimit: 5, // requests per minute
cacheTimeout: 300000 // 5 minutes
},
// Currency MCP
currency: {
port: process.env.CURRENCY_PORT || 3001,
exchangeRateKey: process.env.EXCHANGE_RATE_API_KEY,
rateLimit: 100, // requests per minute
cacheTimeout: 600000 // 10 minutes
},
// Time MCP
time: {
port: process.env.TIME_PORT || 3002,
rateLimit: 1000, // requests per minute
cacheTimeout: 60000 // 1 minute
},
// Units MCP
units: {
port: process.env.UNITS_PORT || 3003,
rateLimit: 1000, // requests per minute
cacheTimeout: 300000 // 5 minutes
}
};
```
### 2. Add Rate Limiting
Install rate limiting:
```bash
npm install express-rate-limit
```
Add to each server:
```javascript
const rateLimit = require('express-rate-limit');
const limiter = rateLimit({
windowMs: 15 * 60 * 1000, // 15 minutes
max: 100 // limit each IP to 100 requests per windowMs
});
app.use(limiter);
```
### 3. Add Logging
```bash
npm install winston
```
Create `utils/logger.js`:
```javascript
const winston = require('winston');
const logger = winston.createLogger({
level: 'info',
format: winston.format.combine(
winston.format.timestamp(),
winston.format.errors({ stack: true }),
winston.format.json()
),
defaultMeta: { service: 'mcp-server' },
transports: [
new winston.transports.File({ filename: 'logs/error.log', level: 'error' }),
new winston.transports.File({ filename: 'logs/combined.log' })
]
});
if (process.env.NODE_ENV !== 'production') {
logger.add(new winston.transports.Console({
format: winston.format.simple()
}));
}
module.exports = logger;
```
---
## 📊 Monitoring & Maintenance
### 1. PM2 Monitoring
```bash
# Check status
pm2 status
# View logs
pm2 logs
# Restart services
pm2 restart all
# Monitor resources
pm2 monit
```
### 2. Set Up Log Rotation
```bash
# Install logrotate
sudo apt install logrotate
# Create logrotate config
sudo nano /etc/logrotate.d/mcp-servers
```
Add:
```
/home/username/MCPAddIn/logs/*.log {
daily
missingok
rotate 7
compress
delaycompress
notifempty
create 644 username username
postrotate
pm2 reloadLogs
endscript
}
```
### 3. Health Checks
Create `health-check.js`:
```javascript
const axios = require('axios');
const servers = [
{ name: 'Stock Market', url: 'http://localhost:3000/mcp' },
{ name: 'Currency', url: 'http://localhost:3001/mcp' },
{ name: 'Time', url: 'http://localhost:3002/mcp' },
{ name: 'Units', url: 'http://localhost:3003/mcp' }
];
async function healthCheck() {
for (const server of servers) {
try {
const response = await axios.get(server.url);
console.log(`✅ ${server.name}: OK`);
} catch (error) {
console.log(`❌ ${server.name}: ERROR - ${error.message}`);
}
}
}
healthCheck();
```
---
## 🔒 Security Considerations
### 1. Firewall Configuration
```bash
# Install UFW
sudo apt install ufw
# Configure firewall
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow ssh
sudo ufw allow 80
sudo ufw allow 443
sudo ufw enable
```
### 2. Environment Security
```bash
# Secure .env file
chmod 600 .env
# Don't commit .env to git
echo ".env" >> .gitignore
```
### 3. API Key Security
- Use environment variables
- Rotate keys regularly
- Monitor API usage
- Set up alerts for unusual activity
---
## 🚀 Deployment Scripts
### Automated Deployment Script
Create `deploy.sh`:
```bash
#!/bin/bash
echo "🚀 Deploying MCP Servers to Hostinger..."
# Build project
echo "📦 Building project..."
npm run build
# Install production dependencies
echo "📥 Installing dependencies..."
npm install --production
# Set up PM2
echo "⚙️ Setting up PM2..."
pm2 delete all
pm2 start ecosystem.config.js
pm2 save
# Restart Nginx
echo "🔄 Restarting Nginx..."
sudo systemctl restart nginx
echo "✅ Deployment complete!"
echo "🌐 Servers available at:"
echo " - Stock Market: https://your-domain.com/stock/"
echo " - Currency: https://your-domain.com/currency/"
echo " - Time: https://your-domain.com/time/"
echo " - Units: https://your-domain.com/units/"
```
Make it executable:
```bash
chmod +x deploy.sh
```
---
## 📱 Testing Your Deployment
### 1. Test Each Server
```bash
# Test Stock Market
curl https://your-domain.com/stock/mcp
# Test Currency
curl https://your-domain.com/currency/mcp
# Test Time
curl https://your-domain.com/time/mcp
# Test Units
curl https://your-domain.com/units/mcp
```
### 2. Test MCP Tools
```bash
# Test currency conversion
curl -X POST https://your-domain.com/currency/mcp/tools/call \
-H "Content-Type: application/json" \
-d '{"name":"convertCurrency","arguments":{"from":"USD","to":"EUR","amount":100}}'
```
### 3. Test Web Interfaces
Visit:
- https://your-domain.com/stock/
- https://your-domain.com/currency/
- https://your-domain.com/time/
- https://your-domain.com/units/
---
## 🆘 Troubleshooting
### Common Issues:
1. **Port Already in Use**
```bash
sudo lsof -i :3000
sudo kill -9 <PID>
```
2. **Permission Denied**
```bash
sudo chown -R $USER:$USER /home/$USER/MCPAddIn
```
3. **Nginx 502 Bad Gateway**
- Check if Node.js servers are running
- Verify proxy_pass URLs
- Check Nginx error logs: `sudo tail -f /var/log/nginx/error.log`
4. **PM2 Not Starting**
```bash
pm2 logs
pm2 restart all
```
5. **SSL Certificate Issues**
```bash
sudo certbot renew --dry-run
```
---
## 📈 Performance Optimization
### 1. Enable Gzip Compression
Add to Nginx config:
```nginx
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css text/xml text/javascript application/javascript application/xml+rss application/json;
```
### 2. Add Caching Headers
```nginx
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
expires 1y;
add_header Cache-Control "public, immutable";
}
```
### 3. Monitor Performance
```bash
# Install monitoring tools
npm install -g clinic
# Profile your app
clinic doctor -- node dist/server.js
```
---
## 🎯 Next Steps
1. **Deploy to Hostinger** using the steps above
2. **Set up monitoring** with PM2 and logs
3. **Configure SSL** for secure connections
4. **Test all endpoints** to ensure everything works
5. **Set up backups** for your server configuration
6. **Monitor performance** and optimize as needed
---
## 📞 Support
If you encounter issues:
1. Check Hostinger's documentation
2. Review server logs: `pm2 logs`
3. Test locally first
4. Check firewall and port configurations
5. Verify environment variables are set correctly
---
## 🎉 Success!
Once deployed, your MCP servers will be available at:
- **Stock Market**: https://your-domain.com/stock/
- **Currency**: https://your-domain.com/currency/
- **Time**: https://your-domain.com/time/
- **Units**: https://your-domain.com/units/
You can now integrate them with ChatGPT or any other application that supports MCP!