SearchAPI MCP Server

A Model Context Protocol (MCP) based search API server that provides standardized access to Google Maps, Google Flights, Google Hotels, and other services. This server enables AI assistants to access various search services through a unified interface.

Overview | 概述

SearchAPI-MCP-Server implements the Model Context Protocol, encapsulating various search operations as tools and resources. It serves as a bridge between AI assistants and search services, supporting map search, flight queries, hotel bookings, and more.

Features | 功能特性

Google Search | Google 搜索

• Web search results | 网页搜索结果
• Knowledge graph integration | 知识图谱集成
• Related questions | 相关问题推荐
• Search suggestions | 搜索建议
• Multi-language support | 多语言支持
• Region-specific results | 地区特定结果
• Time range filtering | 时间范围过滤
• Safe search options | 安全搜索选项

Google Video Search | Google Video 搜索

• Video content search | 视频内容搜索
• Video list retrieval | 视频列表获取
• Video carousel support | 视频轮播支持
• Short video content | 短视频内容
• Duration filtering | 按时长筛选
• Source filtering | 按来源过滤
• Upload time sorting | 按上传时间排序
• HD preview support | 高清预览支持

Google Maps Search | Google Maps 搜索

• Search places and services | 搜索地点和服务
• Get place details | 获取地点详细信息
• View user reviews | 查看用户评论
• Get location coordinates | 获取位置坐标

Google Flights Search | Google Flights 航班搜索

• One-way/round-trip flight search | 单程/往返航班搜索
• Multi-city itinerary planning | 多城市行程规划
• Flight price calendar | 航班价格日历
• Flight filtering and sorting | 航班筛选和排序
• Baggage allowance query | 行李额度查询
• Airline selection | 航空公司选择

Google Hotels Search | Google Hotels 酒店搜索

• Hotel location search | 酒店位置搜索
• Price and availability query | 价格和可用性查询
• Facilities and services filtering | 设施和服务筛选
• User ratings and reviews | 用户评分和评论
• Special offers query | 特殊优惠查询
• Room type selection | 房型选择

Additional SearchAPI Features | SearchAPI 新增功能

• Dashboard and account management | SearchAPI Dashboard 与账号信息
• View search history | 搜索历史记录查看
• More search engine support, such as Google Ads Transparency, Google Shopping, Google Images, Google News, Bing, Baidu, Naver, Yahoo, Amazon, Shein, eBay, Google Play Store, Apple App Store, DuckDuckGo, YouTube
• Dedicated interfaces: Google Travel Explore, Google Hotels Autocomplete, Google Flights Location Search, Google Maps Photos, Google Maps Reviews, Google Maps Place

Installation | 安装说明

Requirements | 环境要求

• Python 3.7 or higher | Python 3.7 或更高版本
• pip package manager | pip 包管理器

Basic Installation | 基础安装

bash

Clone repository | 克隆仓库

git clone https://github.com/RmMargt/searchAPI-mcp.git
cd searchAPI-mcp

Create and activate virtual environment | 创建并激活虚拟环境

python -m venv venv
source venv/bin/activate # Linux/Mac

or | 或

.venvScriptsactivate # Windows

Install dependencies | 安装依赖

pip install -r requirements.txt

MCP Configuration | MCP 配置### Claude for Desktop Configuration Example

Add the following to your Claude for Desktop configuration file:

json
{
"mcpServers": {
"searchapi": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"/path/to/searchAPI-mcp/mcp_server.py"
],
"env": {
"SEARCHAPI_API_KEY": "your_api_key_here"
}
}
}
}

Configuration file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%Claudeclaude_desktop_config.json

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Model Context Protocol - Protocol specification
• FastMCP - Python MCP implementation
• SearchAPI.io - Search service provider

Note: This server interacts with external APIs. Always verify that requested operations are appropriate before confirming them in MCP clients.