网页搜索服务

一个基于Google搜索结果的免费网页搜索服务,无需API密钥即可使用,返回结构化的搜索结果。

  • by williamvd4
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 williamvd4/web-search

使用说明

网络搜索MCP服务器

一个模型上下文协议(MCP)服务器,可以使用谷歌搜索结果进行免费网络搜索,不需要API密钥。

特性

  • 使用谷歌搜索结果搜索网络
  • 无需API密钥或身份验证
  • 返回带有标题、URL和描述的结构化结果
  • 每次搜索可配置的结果数量

安装

  1. 克隆或下载此存储库
  2. 安装依赖项:
npm install
  1. 构建服务器:
npm run build
  1. 将服务器添加到MCP配置中:

对于VSCode(Claude Dev扩展):

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
    }
  }
}

对于Claude Desktop:

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
    }
  }
}

用法

服务器提供了一个名为 search 它接受以下参数:

{
  "query": string,    // The search query
  "limit": number     // Optional: Number of results to return (default: 5, max: 10)
}

示例用法:

use_mcp_tool({
  server_name: "web-search",
  tool_name: "search",
  arguments: {
    query: "your search query",
    limit: 3  // optional
  }
})

示例响应:

[
  {
    "title": "Example Search Result",
    "url": "https://example.com",
    "description": "Description of the search result..."
  }
]

局限性

由于此工具使用谷歌搜索结果的网络抓取,因此有一些重要的局限性需要注意:

  1. 速率限制:如果在短时间内执行了太多搜索,谷歌可能会暂时阻止请求。为了避免这种情况:

    • 保持合理的搜索频率
    • 明智地使用限制参数
    • 如果需要,考虑在搜索之间实施延迟
  2. 结果准确性:

    • 该工具依赖于谷歌的HTML结构,这可能会改变
    • 某些结果可能缺少描述或其他元数据
    • 复杂的搜索运算符可能无法按预期工作
  3. 法律考虑:

    • 此工具仅供个人使用
    • 尊重谷歌的服务条款
    • 考虑为您的用例实施适当的速率限制

贡献

请随时提交问题和增强请求!