mcp-server-indexnow

一个模型上下文协议 (MCP) 服务器，允许通过 IndexNow 协议进行 URL 索引请求。

此服务器充当桥梁，使兼容 MCP 的客户端（如 IDE 或 AI 助手）能够使用 IndexNow 协议向搜索引擎提交 URL，从而可能更快地发现和索引内容。

什么是 IndexNow？

IndexNow 是一个简单的协议，允许网站在其网站内容被创建、更新或删除时轻松通知搜索引擎。通过 IndexNow 提交 URL 会通知参与的搜索引擎（如 Bing、Yandex、Seznam.cz、Naver、Yep）优先抓取这些 URL，从而可能加快搜索结果中更改的反映。

什么是 MCP？

模型上下文协议 (MCP) 是一个标准，用于通过专用服务器将语言模型 (LLM) 和 AI 助手连接到各种工具、数据源和功能。 此服务器实现 MCP 以将 IndexNow 功能公开为一个工具。

特性

• 提供一个 MCP 工具，用于向 IndexNow API 提交单个或多个 URL。
• 促进通过 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) 放在您的 Web 服务器上。 此过程向 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 服务器提交 URL https://your-website.com/updated-page，密钥为 'your-indexnow-key'。

或者对于多个 URL：

助手，请使用 IndexNow 服务器提交以下 URL，密钥为 'your-indexnow-key'：

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

请参阅您的特定 MCP 客户端的文档，了解如何调用服务器工具。 然后，此服务器将向 IndexNow API 端点发出相应的请求，默认情况下为 https://api.indexnow.org/indexnow。

开发

对于开发，您可以使用以下命令：

# 安装依赖项
make install

# 启动服务器
make start

# 运行测试
make test

# 运行 linting
make lint

# 格式化代码
make format

调试

您可以使用 MCP 检查器来调试服务器。

make mcp_inspector

从模板创建

此 MCP 服务器是从 cookiecutter 模板创建的。 要创建类似的服务器，请运行：

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

许可证

mcp-server-indexnow 在 MIT 许可证下获得许可。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。