Selfhosted MCP Server Template

🚀 远程MCP服务器 - 专业SEO检查器

本仓库提供了一个可用于生产环境的远程MCP服务器，可通过任何兼容的客户端（如Claude Desktop、Cursor或Windsurf）运行全栈SEO审计。它由FastMCP框架提供支持，能够在页面SEO、技术健康状况和社交元数据等方面提供结构化的见解，而且无需进行本地设置。

你可以以此为起点，在Hostinger或任何其他云/VPS平台上部署你自己的MCP服务器。该代码库具有模块化的特点，易于扩展，并包含用于自定义请求处理的清晰示例，为你自己的MCP工具奠定了坚实的基础。

🚀 快速开始

部署到Hostinger

使用你的远程MCP服务器

选项1：一键部署你自己的实例

使用Hostinger的一键部署功能来获取你自己的实例：

1. 点击上方的“部署到Hostinger”按钮。
2. Hostinger会自动处理Docker设置和部署。
3. 获取你部署后的URL（例如，https://your-app.hstgr.cloud）。
4. 添加到你的MCP客户端：

{
  "mcpServers": {
    "seo-checker": {
      "url": "https://your-app.hstgr.cloud/mcp",
      "description": "专业的SEO分析和优化建议"
    }
  }
}

选项2：使用FastMCP开发工具

# 确保你的虚拟环境已激活
fastmcp dev local-seo-checker.py

选项3：配置本地MCP服务器

此MCP服务器可与Claude Desktop、Cursor、Windsurf和其他兼容MCP的应用程序配合使用。

配置位置

• Claude Desktop（注意：远程MCP需要较新版本）：
  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%\Claude\claude_desktop_config.json
• Cursor：
  • 设置 > 工具与集成 > MCP工具
  • 或者编辑：~/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

对于本地开发，将以下配置添加到相应的文件中：

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

重要提示：

• 请将路径替换为你虚拟环境和SEO检查器目录的实际路径。
• 本地开发使用local-seo-checker.py（配置更简单）。
• remote-seo-checker.py配置用于远程部署，并带有额外的参数。

✨ 主要特性

• ✅ 全面的SEO分析：标题标签、元描述、标题结构。
• 🖼️ 图像优化：检查替代文本标签并进行可访问性分析。
• ⚡ 技术SEO：页面速度、HTTPS、模式标记检测。
• 📊 内容分析：字数、文本与HTML比例、内容质量。
• 📱 社交媒体标签：开放图和Twitter卡片优化。
• 🎯 SEO评分：加权评分系统并提供可操作的建议。
• 🔍 多种分析类型：全面分析、快速检查和元标签聚焦。
• 🚀 异步操作：具有适当超时处理的非阻塞操作。

📦 安装指南（本地使用）

前提条件

• Python 3.8或更高版本。
• pip包管理器。
• Docker（用于容器化部署）。

设置步骤

1. 克隆仓库

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

2. 创建并激活虚拟环境（推荐）

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

3. 安装依赖项

pip install -r requirements.txt

🚀 部署到Hostinger（一键部署）或其他平台

此MCP服务器可以作为远程MCP服务器部署到各种托管平台上。

Hostinger（推荐 - 一键部署）

Hostinger为此MCP服务器模板提供无缝的一键部署：

1. 点击顶部的“部署到Hostinger”按钮。
2. 如果尚未连接，请连接你的GitHub账户。
3. 从你的仓库中选择此仓库。
4. Hostinger会自动执行以下操作：

• 设置Docker环境。
• 安装所有依赖项。
• 配置正确的端口（8080）。
• 为你提供一个实时URL。

5. 你的MCP服务器已准备就绪！ 使用提供的URL + /mcp。

无需手动配置！ Hostinger会自动处理所有Docker Compose设置。

其他托管平台（手动Docker部署）

对于支持Docker的其他托管平台：

前提条件

• 一个托管账户（Hostinger、VPS等）。
• 托管平台支持Docker。
• 包含你代码的Git仓库。

手动Docker部署（其他平台）

1. 连接到你的服务器

ssh root@your-server-ip

2. 克隆并部署

# 如果未安装Docker，则安装
curl -fsSL https://get.docker.com -o get-docker.sh && sh get-docker.sh

# 克隆你的仓库
git clone https://github.com/hostinger/selfhosted-mcp-server-template.git
cd selfhosted-mcp-server-template

# 使用Docker Compose进行部署
docker-compose up -d --build

3. 配置防火墙（如果需要）

ufw allow 8080/tcp

4. 测试你的部署

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

使用你部署的服务器

部署完成后，配置你的MCP客户端：

{
  "mcpServers": {
    "seo-checker": {
      "url": "http://your-server-domain:8080/mcp",
      "description": "专业的SEO分析和优化建议"
    }
  }
}

💻 使用示例

全面分析

"Analyze the SEO of my-website.com"

快速健康检查

"Do a quick SEO check on competitor.com"

元标签聚焦

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

批量分析

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

📚 详细文档

可用工具

1. analyze_seo

对网页进行全面的SEO分析 用法："Analyze the SEO of example.com" 特性：

• 标题标签分析（长度、内容、问题）。
• 元描述优化。
• 标题结构（H1 - H6）分析。
• 内容质量评估。
• 图像替代文本优化。
• 技术SEO因素。
• 社交媒体标签（开放图、Twitter卡片）。
• 提供建议的整体SEO评分。

2. seo_quick_check

快速进行SEO健康检查 用法："Do a quick SEO check on github.com" 特性：

• 快速评估关键SEO因素。
• 快速状态指示。
• 关键问题总结。
• 基本性能指标。

3. seo_meta_tags_check

专注于元标签和社交媒体优化分析 用法："Check the meta tags for linkedin.com" 特性：

• 详细的元标签分析。
• 开放图标签验证。
• Twitter卡片优化。
• 规范URL分析。
• 机器人元标签检查。

理解结果

SEO评分等级

• 🏆 90 - 100（优秀）：出色的SEO优化。
• 🟢 80 - 89（良好）：优化良好，但需要进行一些小改进。
• 🟡 70 - 79（一般）：SEO表现尚可，有多个优化机会。
• 🟠 60 - 69（需改进）：存在显著的SEO问题，需要关注。
• 🔴 0 - 59（差）：存在重大的SEO问题，需要立即采取行动。

示例输出

🟢 对example.com的SEO分析

🎯 整体SEO得分：85/100（良好）

📄 标题标签
• 内容："Example Domain - Official Website"
• 长度：35个字符
• 状态：✅ 良好

📝 元描述
• 内容："This domain is for use in illustrative examples in documents..."
• 长度：145个字符
• 状态：✅ 良好

🏗️ 标题结构
• H1标签：1个 ✅
• H2标签：3个
• H3标签：2个

📊 内容分析
• 字数：450个单词
• 文本与HTML比例：25.3%
• 状态：✅ 良好

🖼️ 图像优化
• 总图像数：5个
• 带有替代文本的图像数：4个（80%）
• 缺少替代文本的图像数：1个

⚡ 技术SEO
• HTTPS：✅ 是
• 加载时间：1250ms
• 页面大小：45.2 KB
• 模式标记：✅ 是

💡 建议（3条）
• 为1张图像添加替代文本。
• 考虑添加更多内部链接。
• 优化图像以加快加载速度。

🔧 技术细节

故障排除

# 检查服务器是否正在运行
curl http://your-server:8080

# 查看Docker日志
docker-compose logs -f seo-mcp-server

# 本地测试
python remote-seo-checker.py

# 检查端口可用性
netstat -tlnp | grep 8080

开发

本地开发

# 在开发模式下运行
python local-seo-checker.py

# 使用MCP检查器进行测试
npx @modelcontextprotocol/inspector

贡献代码

1. 分叉仓库。
2. 创建一个功能分支。
3. 进行更改。
4. 彻底测试。
5. 提交拉取请求。

添加新的分析功能

SEO检查器设计为易于扩展。你可以通过以下步骤添加新的分析方法：

1. 向SEOChecker类添加方法。
2. 将它们集成到主analyze_page_seo方法中。
3. 添加相应的MCP工具。
4. 更新评分算法。

📄 许可证

本工具根据当前的最佳实践和指南提供SEO分析。SEO是复杂且不断发展的，请始终根据当前的SEO指南验证建议，并考虑你自己的特定用例。

⚠️ 重要提示

本工具提供的SEO分析是基于当前最佳实践和指南。由于SEO复杂且不断发展，请始终根据当前的SEO指南验证建议，并结合自身特定用例进行考虑。

💡 使用建议

• 部署时优先选择Hostinger的一键部署，可避免手动配置的繁琐。
• 本地开发时，使用虚拟环境管理依赖，确保环境的独立性。