网页搜索与内容提取服务

一个轻量级的MCP服务器,用于网页搜索和页面内容提取,支持自定义搜索参数和内容提取。

  • by RainJayTsai
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 RainJayTsai/serp-mcp

使用说明

serp mcp

用于网络搜索和页面内容提取的最小MCP服务器。

特性

  • web_search(q, max_results=10):搜索网络并返回SerpAPI,如 organic_results.
  • fetch_content(url, max_chars=8000):获取页面,去除嘈杂的HTML,并返回可读的文本。

需求

使用uvx(本地仓库)运行

从该存储库根目录:

uvx --from . serp-mcp

使用fastmcp CLI(HTTP传输)运行

uv run fastmcp run src/serp_mcp/server.py:mcp --transport http --port 8000

使用uvx运行(直接从GitHub)

uvx --from "git+https://github.com/RainJayTsai/serp-mcp.git" serp-mcp

如果需要,请固定分支/标记/提交:

uvx --from "git+https://github.com/RainJayTsai/serp-mcp.git@main" serp-mcp
uvx --from "git+https://github.com/RainJayTsai/serp-mcp.git@v0.1.0" serp-mcp

作为软件包安装

pip install "git+https://github.com/RainJayTsai/serp-mcp.git"
serp-mcp

环境变量

  • SERP_BACKEND (默认值: google)
  • SERP_REGION (默认值: zh-TW)
  • SERP_SAFESEARCH (默认值: off)
  • FETCH_TIMEOUT (默认值: 15)
  • FETCH_USER_AGENT (默认:类似Chrome的UA)

例子:

SERP_REGION=us-en SERP_SAFESEARCH=off uvx --from . serp-mcp

本地开发

uv sync
uv run python -m serp_mcp.server

项目布局

src/serp_mcp/server.py   # MCP server and tools
pyproject.toml           # packaging + CLI entrypoint