Kalchev-hub/selfhosted-mcp-server-template

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.

Get Started

To get started, download the latest release from the Releases section. Follow the instructions in the release notes to set up your server.

Deploy this Remote MCP Server to Hostinger

Features

• ✅ Comprehensive SEO Analysis: Analyze title tags, meta descriptions, and header structures to improve your website's visibility.
• 🖼️ Image Optimization: Check alt tags and perform accessibility analysis to enhance user experience.
• ⚙️ Technical Health Checks: Monitor site performance and identify issues affecting your rankings.
• 📊 Social Metadata Insights: Optimize your content for sharing on social media platforms.
• 🔌 Modular Architecture: Easily extend functionality and integrate with other tools.
• 🔒 SSL Support: Ensure secure connections for your server.

Installation

Prerequisites

• A VPS or cloud server (like Hostinger).
• Basic knowledge of terminal commands.
• A compatible client (Claude Desktop, Cursor, Windsurf).

Step-by-Step Guide

1. Set Up Your Server:

   • Choose a VPS plan that fits your needs.
   • Install a Linux distribution (Ubuntu is recommended).

2. Clone the Repository:

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

3. Install Dependencies:

   • Ensure you have Node.js and npm installed.

   npm install
   

4. Configure Your Server:

   • Edit the configuration file to set up your server settings.
   • Define your API keys and other necessary credentials.

5. Run the Server:

   npm start
   

6. Access the API:

   • Use your client to connect to the MCP server.
   • Follow the documentation for making requests.

API Documentation

Endpoints

• GET /seo-analysis: Retrieve SEO analysis for a given URL.
• POST /image-optimization: Submit images for optimization checks.
• GET /technical-health: Get a report on your website's technical health.
• GET /social-metadata: Fetch social media metadata for a URL.

Example Request

curl -X GET "http://your-server-url/seo-analysis?url=https://example.com"

Response Format

The server responds with JSON formatted data, providing insights and recommendations.

Customization

You can extend the server's functionality by adding custom request handlers. The modular structure allows you to create new features or modify existing ones with ease.

Adding a Custom Handler

1. Create a New File: Add a new JavaScript file in the handlers directory.
2. Define Your Logic: Implement the functionality you need.
3. Register the Handler: Update the main server file to include your new handler.

Troubleshooting

• Server Not Responding: Check if the server is running and accessible.
• Errors in Requests: Ensure your requests are correctly formatted and include all necessary parameters.
• Dependency Issues: Verify that all dependencies are installed and up to date.

Community Contributions

We welcome contributions to enhance the functionality of this MCP server. If you have ideas or improvements, please fork the repository and submit a pull request.

How to Contribute

1. Fork the repository.
2. Create a new branch for your feature or fix.
3. Make your changes and commit them.
4. Push your branch to your fork.
5. Submit a pull request with a clear description of your changes.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Support

If you encounter issues or have questions, please check the Releases section for updates and troubleshooting tips. You can also reach out to the community for help.

Topics

This repository covers a range of topics including:

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

Acknowledgments

Thanks to the developers and contributors who have made this project possible. Your efforts help improve SEO tools for everyone.

Further Reading

For more information on SEO best practices and server management, consider exploring these resources:

• Google's SEO Starter Guide
• MDN Web Docs on Web Performance
• W3C Accessibility Guidelines

Conclusion

Explore the potential of your own remote MCP server and take your SEO analysis to the next level. Download the latest release from the Releases section and start your journey today.