Web Search MCP 服务器

一个模型上下文协议 (MCP) 服务器，它允许使用 Google 搜索结果进行免费的网页搜索，无需 API 密钥。

特性

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

安装

1. 克隆或下载此存储库
2. 安装依赖项：

npm install

3. 构建服务器：

npm run build

4. 将服务器添加到您的 MCP 配置：

对于 VSCode (Claude Dev Extension):

{
  "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,    // 搜索查询
  "limit": number     // 可选：要返回的结果数量（默认值：5，最大值：10）
}

用法示例：

use_mcp_tool({
  server_name: "web-search",
  tool_name: "search",
  arguments: {
    query: "您的搜索查询",
    limit: 3  // 可选
  }
})

响应示例：

[
  {
    "title": "示例搜索结果",
    "url": "https://example.com",
    "description": "搜索结果的描述..."
  }
]

限制

由于此工具使用网络抓取 Google 搜索结果，因此需要注意以下一些重要限制：

1. 速率限制：如果在短时间内执行过多搜索，Google 可能会暂时阻止请求。 为了避免这种情况：

   • 保持合理的搜索频率
   • 谨慎使用 limit 参数
   • 如果需要，考虑在搜索之间实施延迟

2. 结果准确性：

   • 该工具依赖于 Google 的 HTML 结构，该结构可能会发生变化
   • 某些结果可能缺少描述或其他元数据
   • 复杂的搜索运算符可能无法按预期工作

3. 法律注意事项：

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

贡献

欢迎提交问题和增强请求！