Web Search MCP Server

一个使用Google搜索结果进行免费网络搜索的Model Context Protocol (MCP)服务器，无需API密钥。

功能

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

安装

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

npm install

3. 构建服务器：

npm run build

4. 将服务器添加到您的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,    // 搜索查询
  "limit": number     // 可选：要返回的结果数量（默认：5，最大：10）
}

使用示例：

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

响应示例：

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

限制

由于此工具使用了对Google搜索结果的网页抓取，需要注意一些重要的限制：

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

   • 保持搜索频率在合理范围内
   • 谨慎使用限制参数
   • 如有必要，考虑在搜索之间实现延迟

2. 结果准确性：

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

3. 法律考量：

   • 此工具旨在用于个人用途
   • 遵守Google的服务条款
   • 考虑根据您的使用情况实施适当的速率限制

贡献

欢迎提交问题和改进请求！