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的一鍵部署，可避免手動配置的繁瑣。
• 本地開發時，使用虛擬環境管理依賴，確保環境的獨立性。