Selfhosted MCP Server Template

🚀 リモートMCPサーバー – プロフェッショナルなSEOチェッカー

このリポジトリは、Claude Desktop、Cursor、Windsurfなどの互換性のあるクライアントを介して、フルスタックのSEO監査を実行するための本番環境向けのリモートMCPサーバーを提供します。FastMCPフレームワークをベースに構築されており、オンページSEO、技術的な健全性、ソーシャルメタデータなどにわたる構造化された洞察を提供します。ローカル環境のセットアップは不要です。

このリポジトリを起点として、Hostingerや他のクラウド/VPSプラットフォーム上に独自のMCPサーバーをデプロイできます。コードベースはモジュール化されており、拡張が容易で、カスタムリクエストのハンドリングに関する明確なサンプルが含まれているため、独自のMCPツールの堅固な基盤となります。

🚀 クイックスタート

HostingerへのリモートMCPサーバーのデプロイ

✨ 主な機能

• ✅ 包括的なSEO分析：タイトルタグ、メタディスクリプション、ヘッダー構造
• 🖼️ 画像最適化：Altタグのチェックとアクセシビリティ分析
• ⚡ 技術的なSEO：ページ速度、HTTPS、スキーママークアップの検出
• 📊 コンテンツ分析：単語数、テキストとHTMLの比率、コンテンツ品質
• 📱 ソーシャルメディアタグ：Open GraphとTwitter Cardsの最適化
• 🎯 SEOスコアリング：アクション可能な推奨事項を含む加重スコアリングシステム
• 🔍 複数の分析タイプ：完全分析、クイックチェック、メタタグ重点分析
• 🚀 非同期操作：適切なタイムアウト処理を伴う非ブロッキング操作

💻 使用例

リモートMCPサーバーの使用方法

オプション1: 独自のインスタンスをデプロイする（ワンクリック）

Hostingerのワンクリックデプロイを使用して、独自のインスタンスを取得します。

1. 上の「Deploy to Hostinger」ボタンをクリックします。
2. Hostingerが自動的にDockerのセットアップとデプロイを処理します。
3. デプロイされたURLを取得します（例: https://your-app.hstgr.cloud）。
4. MCPクライアントに追加します。

{
  "mcpServers": {
    "seo-checker": {
      "url": "https://your-app.hstgr.cloud/mcp",
      "description": "Professional SEO analysis and optimization recommendations"
    }
  }
}

オプション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（推奨 - ワンクリックデプロイ）

Hostingerは、このMCPサーバーテンプレートのシームレスなワンクリックデプロイを提供します。

1. 上部の「Deploy to 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": "Professional SEO analysis and optimization recommendations"
    }
  }
}

利用可能なツール

1. analyze_seo

ウェブページの包括的なSEO分析

使用方法: "Analyze the SEO of example.com"

特徴:

• タイトルタグ分析（長さ、内容、問題点）
• メタディスクリプションの最適化
• ヘッダー構造（H1 - H6）分析
• コンテンツ品質評価
• 画像のAltテキスト最適化
• 技術的なSEO要素
• ソーシャルメディアタグ（Open Graph、Twitter Cards）
• 推奨事項を含む総合的な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"

特徴:

• 詳細なメタタグ分析
• Open Graphタグの検証
• Twitter Cardsの最適化
• 正規URL分析
• ロボットメタタグの検査

使用例

包括的な分析

"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"

結果の理解

SEOスコアの評価

• 🏆 90 - 100 (EXCELLENT): 卓越したSEO最適化
• 🟢 80 - 89 (GOOD): わずかな改善が必要な程度に最適化されています。
• 🟡 70 - 79 (FAIR): いくつかの最適化の機会がある適度なSEO
• 🟠 60 - 69 (NEEDS WORK): 注目が必要な重大なSEO問題
• 🔴 0 - 59 (POOR): 即座の対応が必要な主要なSEO問題

サンプル出力

🟢 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

トラブルシューティング

デバッグコマンド

# サーバーが実行中かどうかを確認
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. スコアリングアルゴリズムを更新します。

サポート

• 📖 ドキュメント: このREADMEとコードのコメントを確認してください。
• 🐛 問題の報告: GitHub Issuesを介してバグを報告してください。

免責事項: このツールは、現在のベストプラクティスとガイドラインに基づいてSEO分析を提供します。SEOは複雑で常に進化しているため、常に最新のSEOガイドラインで推奨事項を検証し、特定のユースケースを考慮してください。