Web Search MCP Server

一个使用Google搜索结果的模型上下文协议（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桌面版：

{
  "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": "示例搜索结果",
    "url": "https://example.com",
    "description": "搜索结果的描述..."
  }
]

限制

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

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

   • 保持搜索频率合理
   • 妥善使用limit参数
   • 如有需要，考虑在搜索之间实施延迟

2. 结果准确性：

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

3. 法律注意事项：

   • 该工具仅限个人使用
   • 尊重Google的服务条款
   • 考虑根据您的使用情况实施适当的速率限制

贡献

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