# Remote MCP Server – Professional SEO Checker
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
[](https://www.hostinger.com/vps/docker-hosting?compose_url=https://raw.githubusercontent.com/hostinger/selfhosted-mcp-server-template/refs/heads/main/docker-compose.yml)
## 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**:
```json
{
"mcpServers": {
"seo-checker": {
"url": "https://your-app.hstgr.cloud/mcp",
"description": "Professional SEO analysis and optimization recommendations"
}
}
}
```
### Option 2: With FastMCP Development Tools
```bash
# 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:
```json
{
"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**
```bash
git clone https://github.com/hostinger/selfhosted-mcp-server-template.git
cd selfhosted-mcp-server-template
```
2. **Create and activate a virtual environment (recommended)**
```bash
python -m venv venv
# On macOS/Linux
source venv/bin/activate
# On Windows
venv\Scripts\activate
```
3. **Install dependencies**
```bash
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**
```bash
ssh root@your-server-ip
```
2. **Clone and deploy**
```bash
# 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)
```bash
ufw allow 8080/tcp
```
4. **Test your deployment**
```bash
curl http://your-server-ip:8080
```
### Using Your Deployed Server
Once deployed, configure your MCP client:
```json
{
"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
<img width="494" height="569" alt="test-run" src="https://github.com/user-attachments/assets/311337d8-b444-44c1-8eca-b052a04ecb8b" />
### 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
```bash
# 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
```bash
# 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.