Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

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


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

chatgpt claude cursor hostinger mcp remote-mcp self-hosted ssl vps website-health

Last synced: 21 days ago
JSON representation

Awesome Lists containing this project

README 

          
# 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

[![Deploy on Hostinger](https://assets.hostinger.com/vps/deploy.svg)](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



test-run



### 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.