mcp-server-indexnow

mcp-server-indexnow

IndexNow プロトコルを使用して URL のインデックス登録リクエストを送信できる、Model Context Protocol（MCP）サーバーです。

このサーバーは、MCP 対応クライアント（IDE や AI アシスタントなど）から IndexNow プロトコルを使用して検索エンジンに URL を送信できるようにするブリッジとして機能し、コンテンツの発見とインデックス登録を早められる可能性があります。

IndexNow とは？

IndexNow は、ウェブサイトのコンテンツが作成、更新、削除されたときに、検索エンジンへ簡単に通知できるシンプルなプロトコルです。IndexNow 経由で URL を送信すると、参加している検索エンジン（Bing、Yandex、Seznam.cz、Naver、Yep など）にその URL のクロールを優先するよう通知され、検索結果への変更の反映が早まる可能性があります。

MCP とは？

Model Context Protocol（MCP） は、専用サーバーを通じて言語モデル（LLM）や AI アシスタントをさまざまなツール、データソース、機能に接続するための標準です。このサーバーは MCP を実装し、IndexNow の機能をツールとして提供します。

機能

• IndexNow API に単一または複数の URL を送信する MCP ツールを提供します。
• MCP クライアントを通じて IndexNow プロトコルを利用できます。
• ホストに IndexNow キーを設定すれば、必要な設定は最小限です。

インストール

uvx を使用する（推奨）

uvx を使用する場合、特別なインストールは不要です。クライアントアプリから mcp_server_indexnow を直接実行します。

uvx を使用して Claude デスクトップに追加する

Claude の設定に次を指定してください。

"mcpServers": {
  "mcp_server_indexnow": {
    "command": "uvx",
    "args": [
      "--from",
      "git+https://github.com/zizzfizzix/mcp-server-indexnow",
      "mcp_server_indexnow"
    ]
  }
}

uvx を使用して Zed に追加する

Zed の settings.json に次を追加してください。

"context_servers": [
  "mcp_server_indexnow": {
    "command": "uvx",
    "args": [
      "--from",
      "git+https://github.com/zizzfizzix/mcp-server-indexnow",
      "mcp_server_indexnow"
    ]
  }
],

make を使用する

または、make を使用して mcp_server_indexnow をインストールできます。

make install

make を使用して Claude デスクトップに追加する

Claude の設定に次を指定してください。

"mcpServers": {
  "mcp_server_indexnow": {
    "command": "/path/to/mcp-server-indexnow/.venv/bin/python",
    "args": ["/path/to/mcp-server-indexnow/mcp_server_indexnow/main.py"]
  }
}

make を使用して Zed に追加する

Zed の settings.json に次を追加してください。

"context_servers": {
  "mcp_server_indexnow": {
    "command": "/path/to/mcp-server-indexnow/.venv/bin/python",
    "args": ["/path/to/mcp-server-indexnow/mcp_server_indexnow/main.py"]
  }
}

使い方

この MCP サーバーをアシスタントアプリに正常に追加したら、以下の手順に従ってください。

1. IndexNow キーの設定（必須）

このサーバーを使用する前に、ウェブサイトのホスト用に IndexNow キーを必ず設定してください。キーを生成し、特定のテキストファイル（{your-key}.txt）をウェブサーバーに配置します。この手順により、IndexNow に対してホストの所有権を証明します。

• IndexNow の公式手順に従ってください： キーを使用した所有権の確認
• このサーバーが提供する URL 送信ツールを呼び出すときに、キーが必要になります。安全に保管してください。

2. 環境変数（任意）

このサーバーでは、設定用に次の環境変数を使用できます。

• INDEXNOW_SECRET_KEY：この環境変数に IndexNow キーを設定すると、URL の送信時にサーバーがそのキーをデフォルトで使用します。これにより、AI アシスタントにキーを知られずに済みます。たとえば、ツールの呼び出し時に key 引数を指定すれば、引き続き上書きできます。

"mcpServers": {
  "mcp_server_indexnow": {
    "command": "uvx",
    "args": [
      "--from",
      "git+https://github.com/zizzfizzix/mcp-server-indexnow",
      "mcp_server_indexnow"
    ],
    "env": {
      "INDEXNOW_SECRET_KEY": "https://example.com/2134131231.txt"
    }
  }
}

• INDEXNOW_API_BASE：別の IndexNow API エンドポイントを指定できます。デフォルトは https://api.indexnow.org/indexnow です。全リストは indexnow.com をご覧ください。通常は、ネットワーク遅延や特定の参加検索エンジンを重視する場合にのみ変更してください。各検索エンジンは送信されたイベントをバックグラウンドで共有しますが、反映に遅れが生じる可能性はあります。

"mcpServers": {
  "mcp_server_indexnow": {
    "command": "uvx",
    "args": [
      "--from",
      "git+https://github.com/zizzfizzix/mcp-server-indexnow",
      "mcp_server_indexnow"
    ],
    "env": {
      "INDEXNOW_API_BASE": "https://www.bing.com/indexnow"
    }
  }
}

• INDEXNOW_KEY_LOCATION：任意です。キーのファイルをルート（/keyfilename.txt）以外にホストする場合、そのファイルの完全な URL を指定します。IndexNow のドキュメントに記載されているオプション 2 に従った場合に使用してください。

"mcpServers": {
  "mcp_server_indexnow": {
    "command": "uvx",
    "args": [
      "--from",
      "git+https://github.com/zizzfizzix/mcp-server-indexnow",
      "mcp_server_indexnow"
    ],
    "env": {
      "INDEXNOW_KEY_LOCATION": "https://example.com/some/path/myIndexNowKey63638.txt"
    }
  }
}

例

MCP クライアント（AI アシスタントなど）とやり取りして、ツールを呼び出します。具体的なコマンドはクライアントによって異なる場合がありますが、概念的には次のようになります。

アシスタント、IndexNow サーバーを使って、キー 'your-indexnow-key' で URL https://your-website.com/updated-page を送信してください。

複数の URL の場合は次のようになります。

アシスタント、IndexNow サーバーを使って、キー 'your-indexnow-key' で次の URL を送信してください。

• https://your-website.com/new-article-1
• https://your-website.com/new-article-2
• https://your-website.com/deleted-page

サーバーツールの呼び出し方法については、使用している MCP クライアントのドキュメントを参照してください。このサーバーは、デフォルトで https://api.indexnow.org/indexnow の IndexNow API エンドポイントに適切なリクエストを送信します。

開発

開発には、次のコマンドを使用できます。

# Install dependencies
make install

# Start the server
make start

# Run tests
make test

# Run linting
make lint

# Format code
make format

デバッグ

MCP インスペクターを使ってサーバーをデバッグできます。

make mcp_inspector

テンプレートからの作成

この MCP サーバーは cookiecutter テンプレートから作成されました。同様のサーバーを作成するには、次を実行します。

uvx cookiecutter gh:zizzfizzix/python-base-mcp-server

ライセンス

mcp-server-indexnow は MIT License の下でライセンスされています。MIT License の条項と条件に従うことを前提に、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。