STARWARCLOUD STARWAR.AI
返回市场
自托管-mcp服务器模板

自托管-mcp服务器模板

作者：hostinger11 星标更新：2025-08-26
安装使用来源：spider==github.com

项目介绍

远程MCP服务器 – 专业SEO检查器

此仓库提供了一个生产就绪的远程MCP服务器，用于通过任何兼容客户端（如Claude Desktop、Cursor或Windsurf）运行全栈SEO审计。该服务器由FastMCP框架驱动，提供了关于页面SEO、技术健康和社会元数据的结构化洞察——无需本地设置。

使用此作为起点，在Hostinger或其他云/VPS平台上部署您自己的MCP服务器。代码库是模块化的，易于扩展，并包括清晰的自定义请求处理示例，使其成为您自己MCP工具的强大基础。

将此远程MCP服务器部署到Hostinger

在Hostinger上部署

功能

  • ✅ 全面的SEO分析：标题标签、元描述、头部结构
  • 🖼️ 图像优化：Alt标签检查和可访问性分析
  • ⚡ 技术SEO：页面速度、HTTPS、模式标记检测
  • 📊 内容分析：字数统计、文本到HTML比率、内容质量
  • 📱 社交媒体标签：Open Graph和Twitter Cards优化
  • 🎯 SEO评分：带操作建议的加权评分系统
  • 🔍 多种分析类型：全面分析、快速检查和元标签重点
  • 🚀 异步操作：非阻塞操作并正确处理超时

使用您的远程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配置用于远程部署，带有额外参数

安装（本地使用）

先决条件

  • 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分析和优化建议"
    }
  }
}

可用工具

1. analyze_seo

网页的全面SEO分析

用法："分析example.com的SEO"

特性：

  • 标题标签分析（长度、内容、问题）
  • 元描述优化
  • 头部结构（H1-H6）分析
  • 内容质量评估
  • 图像alt文本优化
  • 技术SEO因素
  • 社交媒体标签（Open Graph、Twitter Cards）
  • 带有建议的整体SEO评分

2. seo_quick_check

快速SEO健康检查

用法："对github.com进行快速SEO检查"

特性：

  • 关键SEO因素的快速评估
  • 快速状态指示器
  • 关键问题摘要
  • 基本性能指标

3. seo_meta_tags_check

专注于元标签和社会媒体优化的分析

用法："检查linkedin.com的元标签"

特性：

  • 详细的元标签分析
  • Open Graph标签验证
  • Twitter Cards优化
  • 规范URL分析
  • Robots元标签检查

使用示例

<img width="494" height="569" alt="test-run" src="https://gips0.baidu.com/it/u=602104941,202516396&fm=3081&app=3081&f=PNG?w=494&h=569" />

全面分析

"分析my-website.com的SEO"

快速健康检查

"对competitor.com进行快速SEO检查"

元标签重点

"检查blog-post-url.com的元标签和社会媒体优化"

批量分析

"比较google.com、bing.com和duckduckgo.com的SEO"

理解结果

SEO评分等级

  • 🏆 90-100（优秀）：出色的SEO优化
  • 🟢 80-89（良好）：优化良好，需少量改进
  • 🟡 70-79（一般）：不错的SEO，有多个优化机会
  • 🟠 60-69（需要努力）：显著的SEO问题需要关注
  • 🔴 0-59（差）：主要的SEO问题需要立即行动

示例输出

🟢 对example.com的SEO分析

🎯 总体SEO评分：85/100（良好）

📄 标题标签
• 内容："Example Domain - 官方网站"
• 长度：35个字符
• 状态：✅ 良好

📝 元描述
• 内容："此域用于文档中的说明性示例..."
• 长度：145个字符
• 状态：✅ 良好

🏗️ 头部结构
• H1标签：1 ✅
• H2标签：3
• H3标签：2

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

🖼️ 图像优化
• 总图像数量：5
• 带有Alt文本：4（80%）
• 缺少Alt文本：1

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

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

故障排除

调试命令

# 检查服务器是否正在运行
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 Inspector测试
npx @modelcontextprotocol/inspector

贡献

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

添加新的分析功能

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

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

支持

  • 📖 文档：查看此README和代码注释
  • 🐛 问题：通过GitHub Issues报告错误

免责声明：此工具基于当前的最佳实践和指南提供SEO分析。SEO复杂且不断演变——始终根据当前SEO指南验证建议，并考虑您的具体情况。