使用说明
serp mcp
用于网络搜索和页面内容提取的最小MCP服务器。
特性
web_search(q, max_results=10):搜索网络并返回SerpAPI,如organic_results.fetch_content(url, max_chars=8000):获取页面,去除嘈杂的HTML,并返回可读的文本。
需求
- python
>=3.12 - 紫外线
使用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