网页搜索服务

一个强大的MCP服务器,为AI代理提供互联网搜索和网页内容获取能力。

  • by jsitla
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 jsitla/MCP-Web-Search

使用说明

MCP Web搜索服务器

一个强大的模型上下文协议(MCP)服务器,为AI代理提供互联网搜索和网络内容功能。

特性

此MCP服务器提供 19工具 对于网络交互:

🔍 搜索工具

  • search_web -DuckDuckGo文本搜索
  • search_news -最新新闻搜索
  • search_images -图片搜索
  • search_youtube -YouTube视频搜索
  • search_wikipedia -维基百科文章搜索
  • search_maps -地点/地图搜索
  • batch_search -一次呼叫中有多个查询

🌐 Web获取工具

  • fetch_webpage -获取静态HTML页面
  • fetch_webpage_js -获取JavaScript渲染的页面(剧作家)
  • fetch_as_markdown -将网页转换为干净的Markdown(LLM友好)
  • crawl_website -多页面网站爬行

📄 内容提取工具

  • get_youtube_transcript -提取YouTube视频转录本
  • read_pdf_url -从URL读取PDF文档
  • extract_links -从页面中提取所有链接
  • get_page_metadata -获取SEO/元信息
  • take_screenshot -捕获网页截图

🛠️ 实用工具

  • get_weather -天气查询
  • translate_text -文本翻译
  • clear_cache -清除缓存结果

安装

先决条件

  • Python 3.10+
  • 点

设置

  1. 克隆存储库:
git clone https://github.com/YOUR_USERNAME/MCP-Web-Search.git
cd MCP-Web-Search
  1. 创建并激活虚拟环境:
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
  1. 安装依赖项:
pip install fastmcp ddgs httpx lxml playwright markdownify youtube-transcript-api pymupdf
  1. 安装Playwright浏览器:
python -m playwright install chromium

配置

VS代码(GitHub副本)

添加到您的 settings.json 或创建 .vscode/mcp.json:

{
  "servers": {
    "internet-search": {
      "type": "stdio",
      "command": "/path/to/.venv/Scripts/python.exe",
      "args": ["/path/to/search_server.py"]
    }
  }
}

谷歌反重力IDE

添加到您的 mcp_config.json:

{
  "mcpServers": {
    "internet-search": {
      "command": "/path/to/.venv/Scripts/python.exe",
      "args": ["/path/to/search_server.py"],
      "env": {}
    }
  }
}

克劳德桌面版

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "internet-search": {
      "command": "/path/to/.venv/Scripts/python.exe",
      "args": ["/path/to/search_server.py"]
    }
  }
}

使用示例

配置后,您可以询问您的AI助手:

  • “在网上搜索Python 3.13的最新功能”
  • “以markdown格式从python.org获取内容”
  • “获取此YouTube视频的文字记录:[URL]”
  • “阅读此PDF文档:[URL]”
  • “截取example.com的屏幕截图”
  • “纽约的天气怎么样?”

测试

在测试模式下运行服务器:

python search_server.py --test "your search query"

许可证

MIT许可证

贡献

欢迎投稿!请随时提交拉取请求。