Web Search MCP 服务器

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

功能

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

安装

1. 克隆或下载此仓库

2. 安装依赖项：
   bash
   npm install

3. 构建服务器：
   bash
   npm run build

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

对于 VSCode（Claude Dev 扩展）：
json
{
"mcpServers": {
"web-search": {
"command": "node",
"args": ["/path/to/web-search/build/index.js"]
}
}
}

对于 Claude Desktop：
json
{
"mcpServers": {
"web-search": {
"command": "node",
"args": ["/path/to/web-search/build/index.js"]
}
}
}

使用方法

该服务器提供了一个名为 search 的工具，接受以下参数：

typescript
{
"query": string, // 搜索查询
"limit": number // 可选：返回的结果数量（默认：5，最大：10）
}

示例用法：
typescript
use_mcp_tool({
server_name: "web-search",
tool_name: "search",
arguments: {
query: "your search query",
limit: 3 // 可选
}
})

示例响应：
json
[
{
"title": "Example Search Result",
"url": "https://example.com",
"description": "Description of the search result..."
}
]

限制

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

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

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

2. 结果准确性：

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

3. 法律考虑：

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

贡献

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