Selfhosted Mcp Server Template

This repository provides a production-ready remote MCP server for running full-stack SEO audits via any compatible client (like Claude Desktop, Cursor, or Windsurf). Powered by the FastMCP framework, it delivers structured insights across on-page SEO, technical health, and social metadata — all without requiring local setup.

Use this as a starting point to deploy your own MCP server on Hostinger or any other cloud/VPS platform. The codebase is modular, easy to extend, and includes clear examples for custom request handling, making it a solid foundation for your own MCP tools.

Deploy this Remote MCP Server to Hostinger

Deploy on Hostinger

Features

• ✅ Comprehensive SEO Analysis: Title tags, meta descriptions, headers structure
• 🖼️ Image Optimization: Alt tags checking and accessibility analysis
• ⚡ Technical SEO: Page speed, HTTPS, schema markup detection
• 📊 Content Analysis: Word count, text-to-HTML ratio, content quality
• 📱 Social Media Tags: Open Graph and Twitter Cards optimization
• 🎯 SEO Scoring: Weighted scoring system with actionable recommendations
• 🔍 Multiple Analysis Types: Full analysis, quick checks, and meta tags focus
• 🚀 Async Operations: Non-blocking operations with proper timeout handling

Using Your Remote MCP Server

Option 1: Deploy Your Own Instance (1-Click)

Use Hostinger's 1-click deploy to get your own instance:

1. Click the "Deploy to Hostinger" button above
2. Hostinger automatically handles the Docker setup and deployment
3. Get your deployed URL (e.g., https://your-app.hstgr.cloud)
4. Add to your MCP client:

{
  "mcpServers": {
    "seo-checker": {
      "url": "https://your-app.hstgr.cloud/mcp",
      "description": "Professional SEO analysis and optimization recommendations"
    }
  }
}

Option 2: With FastMCP Development Tools

# Make sure your virtual environment is activated
fastmcp dev local-seo-checker.py

Option 3: Configure Local MCP Server

This MCP server works with Claude Desktop, Cursor, Windsurf, and other MCP-compatible applications.

Configuration Locations

• Claude Desktop (Note: Remote MCP requires newer versions):

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

• Cursor:

  • Settings > Tools & Integrations > MCP Tools
  • Or edit: ~/Library/Application Support/Cursor/cursor_desktop_config.json (macOS)
  • Windows: %APPDATA%\Cursor\cursor_desktop_config.json

• Windsurf:

  • macOS: ~/Library/Application Support/Windsurf/windsurf_desktop_config.json
  • Windows: %APPDATA%\Windsurf\windsurf_desktop_config.json

For local development, add the following configuration to the appropriate file:

{
  "mcpServers": {
    "seo-checker": {
      "command": "/path/to/your/venv/bin/python",
      "args": ["/path/to/your/local-seo-checker.py"]
    }
  }
}

Important:

• Replace paths with the actual paths to your virtual environment and SEO checker directory
• Use local-seo-checker.py for local development (simpler configuration)
• remote-seo-checker.py is configured for remote deployment with additional parameters

Installation (For Local Use)

Prerequisites

• Python 3.8 or higher
• pip package manager
• Docker (for containerized deployment)

Setup

1. Clone the repository

   git clone https://github.com/hostinger/selfhosted-mcp-server-template.git
   cd selfhosted-mcp-server-template
   

2. Create and activate a virtual environment (recommended)

   python -m venv venv
   # On macOS/Linux
   source venv/bin/activate
   # On Windows
   venv\Scripts\activate
   

3. Install dependencies

   pip install -r requirements.txt
   

Deploy to Hostinger (1-Click) or Other Platforms

This MCP server can be deployed as a remote MCP server on various hosting platforms.

Hostinger (Recommended - 1-Click Deploy)

Hostinger provides seamless 1-click deployment for this MCP server template:

1. Click "Deploy to Hostinger" button at the top
2. Connect your GitHub account if not already connected
3. Select this repository from your repositories
4. Hostinger automatically:
   • Sets up the Docker environment
   • Installs all dependencies
   • Configures the correct port (8080)
   • Provides you with a live URL
5. Your MCP server is ready! Use the provided URL + /mcp

No manual configuration needed! Hostinger handles all the Docker Compose setup automatically.

Other Hosting Platforms (Manual Docker Deployment)

For other hosting platforms that support Docker:

Prerequisites

• A hosting account (Hostinger, VPS, etc.)
• Docker support on your hosting platform
• Git repository with your code

Manual Docker Deployment (Other Platforms)

1. Connect to your server

   ssh root@your-server-ip
   

2. Clone and deploy

   # Install Docker if not present
   curl -fsSL https://get.docker.com -o get-docker.sh && sh get-docker.sh
   
   # Clone your repository
   git clone https://github.com/hostinger/selfhosted-mcp-server-template.git
   cd selfhosted-mcp-server-template
   
   # Deploy with Docker Compose
   docker-compose up -d --build
   

3. Configure firewall (if needed)

   ufw allow 8080/tcp
   

4. Test your deployment

   curl http://your-server-ip:8080
   

Using Your Deployed Server

Once deployed, configure your MCP client:

{
  "mcpServers": {
    "seo-checker": {
      "url": "http://your-server-domain:8080/mcp",
      "description": "Professional SEO analysis and optimization recommendations"
    }
  }
}

Available Tools

1. analyze_seo

Comprehensive SEO analysis of a webpage

Usage: "Analyze the SEO of example.com"

Features:

• Title tag analysis (length, content, issues)
• Meta description optimization
• Header structure (H1-H6) analysis
• Content quality assessment
• Image alt text optimization
• Technical SEO factors
• Social media tags (Open Graph, Twitter Cards)
• Overall SEO scoring with recommendations

2. seo_quick_check

Quick SEO health check

Usage: "Do a quick SEO check on github.com"

Features:

• Rapid assessment of key SEO factors
• Quick status indicators
• Summary of critical issues
• Basic performance metrics

3. seo_meta_tags_check

Focused analysis of meta tags and social media optimization

Usage: "Check the meta tags for linkedin.com"

Features:

• Detailed meta tags analysis
• Open Graph tags verification
• Twitter Cards optimization
• Canonical URL analysis
• Robots meta tag inspection

Usage Examples

Comprehensive Analysis

"Analyze the SEO of my-website.com"

Quick Health Check

"Do a quick SEO check on competitor.com"

Meta Tags Focus

"Check the meta tags and social media optimization for blog-post-url.com"

Batch Analysis

"Compare the SEO of google.com, bing.com, and duckduckgo.com"

Understanding Results

SEO Score Grades

• 🏆 90-100 (EXCELLENT): Outstanding SEO optimization
• 🟢 80-89 (GOOD): Well-optimized with minor improvements needed
• 🟡 70-79 (FAIR): Decent SEO with several optimization opportunities
• 🟠 60-69 (NEEDS WORK): Significant SEO issues requiring attention
• 🔴 0-59 (POOR): Major SEO problems that need immediate action

Sample Output

🟢 SEO Analysis for example.com

🎯 OVERALL SEO SCORE: 85/100 (GOOD)

📄 TITLE TAG
• Content: "Example Domain - Official Website"
• Length: 35 characters
• Status: ✅ Good

📝 META DESCRIPTION
• Content: "This domain is for use in illustrative examples in documents..."
• Length: 145 characters
• Status: ✅ Good

🏗️ HEADER STRUCTURE
• H1 Tags: 1 ✅
• H2 Tags: 3
• H3 Tags: 2

📊 CONTENT ANALYSIS
• Word Count: 450 words
• Text-to-HTML Ratio: 25.3%
• Status: ✅ Good

🖼️ IMAGE OPTIMIZATION
• Total Images: 5
• With Alt Text: 4 (80%)
• Missing Alt Text: 1

⚡ TECHNICAL SEO
• HTTPS: ✅ Yes
• Load Time: 1250ms
• Page Size: 45.2 KB
• Schema Markup: ✅ Yes

💡 RECOMMENDATIONS (3)
• Add alt text to 1 images
• Consider adding more internal links
• Optimize images for faster loading

Troubleshooting

Debug Commands

# Check if server is running
curl http://your-server:8080

# View Docker logs
docker-compose logs -f seo-mcp-server

# Test locally
python remote-seo-checker.py

# Check port availability
netstat -tlnp | grep 8080

Development

Local Development

# Run in development mode
python local-seo-checker.py

# Test with MCP Inspector
npx @modelcontextprotocol/inspector

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

Adding New Analysis Features

The SEO checker is designed to be easily extensible. You can add new analysis methods by:

1. Adding methods to the SEOChecker class
2. Integrating them into the main analyze_page_seo method
3. Adding corresponding MCP tools
4. Updating the scoring algorithm

Support

• 📖 Documentation: Check this README and code comments
• 🐛 Issues: Report bugs via GitHub Issues

---

Disclaimer: This tool provides SEO analysis based on current best practices and guidelines. SEO is complex and constantly evolving - always verify recommendations with current SEO guidelines and consider your specific use case.