Skip to main content
Glama
serpapi

SerpApi MCP Server

by serpapi

SerpApi MCP 服务器

一个模型上下文协议 (MCP) 服务器实现,与 SerpApi 集成,用于获取全面的搜索引擎结果和数据提取。

Python 3.13+ MIT License Install in VS Code Install in Cursor

功能

  • 多引擎搜索:Google、Bing、Yahoo、DuckDuckGo、YouTube、eBay 以及更多

  • 引擎资源:通过 MCP 资源提供各引擎的参数模式(参见搜索工具)

  • 实时天气数据:通过搜索查询获取基于位置的天气预报

  • 股票市场数据:通过搜索集成获取公司财务和市场数据

  • 动态结果处理:自动检测并格式化不同类型的结果

  • 灵活的响应模式:完整或紧凑的 JSON 响应

  • JSON 响应:具有完整或紧凑模式的结构化 JSON 输出

Related MCP server: SearXNG MCP Server

快速入门

SerpApi MCP 服务器作为托管服务提供,网址为 mcp.serpapi.com。为了连接到它,您需要提供 API 密钥。您可以在 SerpApi 仪表板上找到您的 API 密钥。

您可以配置 Claude Desktop 以使用托管服务器:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

自托管

git clone https://github.com/serpapi/serpapi-mcp.git
cd serpapi-mcp
uv sync && uv run src/server.py

配置 Claude Desktop:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "http://localhost:8000/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

获取您的 API 密钥:serpapi.com/manage-api-key

身份验证

支持两种方法:

  • 基于路径/YOUR_API_KEY/mcp(推荐)

  • 基于标头Authorization: Bearer YOUR_API_KEY

示例:

# Path-based
curl "https://mcp.serpapi.com/your_key/mcp" -d '...'

# Header-based  
curl "https://mcp.serpapi.com/mcp" -H "Authorization: Bearer your_key" -d '...'

搜索工具

MCP 服务器拥有一个主要的搜索工具,支持所有 SerpApi 引擎和结果类型。您可以在 SerpApi API 参考中找到所有可用参数。 引擎参数模式也作为 MCP 资源公开:serpapi://engines(索引)和 serpapi://engines/<engine>

您可以提供的参数特定于每个 API 引擎。下面提供了一些示例参数:

  • params.q(必需):搜索查询

  • params.engine:搜索引擎(默认:"google_light")

  • params.location:地理位置过滤器

  • mode:响应模式 - "complete"(默认)或 "compact"

  • ...请参阅 SerpApi API 参考中的其他参数

示例:

{"name": "search", "arguments": {"params": {"q": "coffee shops", "location": "Austin, TX"}}}
{"name": "search", "arguments": {"params": {"q": "weather in London"}}}
{"name": "search", "arguments": {"params": {"q": "AAPL stock"}}}
{"name": "search", "arguments": {"params": {"q": "news"}, "mode": "compact"}}
{"name": "search", "arguments": {"params": {"q": "detailed search"}, "mode": "complete"}}

支持的引擎: Google、Bing、Yahoo、DuckDuckGo、YouTube、eBay 等(参见 serpapi://engines)。

结果类型: 答案框、自然搜索结果、新闻、图片、购物 - 自动检测并格式化。

开发

# Local development
uv sync && uv run src/server.py

# Docker
docker build -t serpapi-mcp . && docker run -p 8000:8000 serpapi-mcp

# Regenerate engine resources (Playground scrape)
python build-engines.py

# Testing with MCP Inspector
npx @modelcontextprotocol/inspector
# Configure: URL mcp.serpapi.com/YOUR_KEY/mcp, Transport "Streamable HTTP transport"

故障排除

  • "Missing API key":在 URL 路径 /{YOUR_KEY}/mcp 或标头 Bearer YOUR_KEY 中包含密钥

  • "Invalid key":在 serpapi.com/dashboard 验证

  • "Rate limit exceeded":等待或升级您的 SerpApi 套餐

  • "No results":尝试不同的查询或引擎

贡献

  1. Fork 本仓库

  2. 创建您的功能分支:git checkout -b feature/amazing-feature

  3. 安装依赖:uv install

  4. 进行更改

  5. 提交更改:git commit -m 'Add amazing feature'

  6. 推送到分支:git push origin feature/amazing-feature

  7. 发起 Pull Request

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

A
license - permissive license
Not graded
quality - not tested
A
maintenance

Maintenance

UpdatingMaintainers
UpdatingResponse time
Release cycle
0Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    An MCP server that integrates with the SearXNG API to provide comprehensive web search capabilities with features like time filtering, language selection, and safe search. It also enables users to fetch and convert web content from specific URLs into markdown format.
    2
    22
    4
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that enables web search capabilities by integrating with a SearXNG instance to aggregate results from over 130 engines. It allows users to perform filtered searches across categories like news, science, and social media while supporting advanced parameters for language and time range.
    9
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    An MCP server that integrates the SearXNG API for web search and URL content extraction with advanced features like pagination, caching, and proxy support.
    4
    14,640
    2
    MIT

View all related MCP servers

Related MCP Connectors

  • MCP server for Google search results via SERP API

  • Serper MCP — wraps the Serper Google Search API (serper.dev)

  • SerpApi MCP — wraps SerpApi (serpapi.com) search engines

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/serpapi/serpapi-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server