Web Compass

网络指南针

用于AI代理的MCP服务器——通过Yandex和谷歌进行网络搜索和内容提取，针对RU/CIS和全球结果进行了优化。

为什么

大多数人工智能搜索工具都是围绕英语网络构建的。该项目通过Yandex为俄罗斯和独联体搜索以及全球谷歌搜索添加了一流的支持，使其对需要处理RU/CIS内容的代理非常有用。

工具

每个工具都可以通过MCP（主要）和REST API（次要）获得。

search_yandex

通过Yandex搜索网页。针对俄罗斯和独联体的结果进行了优化。

• query --搜索查询
• topK --结果数量（1-10）
• region — russia （默认）或 cis

search_google

通过谷歌在全球范围内搜索网络。

• query --搜索查询
• topK --结果数量（1-10）

extract

按URL获取页面并提取主要可读内容。

• urls --URL列表（1-10）

search_and_extract_yandex

通过Yandex进行搜索，并在一个管道中从结果中提取内容。

• query --搜索查询
• topK --结果数量（1-10）
• region — russia （默认）或 cis

search_and_extract_google

通过谷歌搜索，并在一个管道中从结果中提取内容。

• query --搜索查询
• topK --结果数量（1-10）

每个工具还具有相应的REST端点： POST /search-yandex, POST /search-google, POST /extract, POST /search-and-extract-yandex, POST /search-and-extract-google

连接到MCP客户端

将服务器添加到MCP客户端配置中。Claude Desktop示例(claude_desktop_config.json):

{
  "mcpServers": {
    "web-compass": {
      "url": "http://localhost:3000/mcp",
      "transportType": "streamable-http"
    }
  }
}

对于其他客户（Cursor、Windsurf等），请指向 http://your-host:3000/mcp 和 streamable-http 运输。

在幕后

需要SerpAPI密钥。得到一个在 蛇网.

将其添加到您的 .env:

SERPAPI_KEY=your_key_here

看 .env.example 获取所需环境变量的完整列表。

跑步

发展：

npm run start:dev

生产：

npm run build && npm run start:prod