Skip to main content

MCP Search Server

A Model Context Protocol (MCP) server that provides web search capabilities via Gemini's grounding API.

Features

  • 🔍 Real-time web search powered by Google Gemini
  • ⚡ Built-in caching (5 min TTL)
  • 🎯 Structured search results (Title + URL + Summary)
  • 🌍 Multi-language support

Installation

pip install mcp-search-server

Configuration

Set environment variables:

export MCP_SEARCH_URL="http://localhost:8045/v1/messages"
export MCP_SEARCH_API_KEY="your-api-key"
export MCP_SEARCH_MODEL="gemini-3-flash"  # or gemini-3-pro-high
export MCP_SEARCH_CACHE_TTL="300"  # seconds

Usage

As MCP Server (with Zed, Claude Desktop, etc.)

{
  "mcpServers": {
    "mcp-search": {
      "command": "python",
      "args": ["-m", "mcp_search"],
      "env": {
        "MCP_SEARCH_URL": "http://localhost:8045/v1/messages",
        "MCP_SEARCH_API_KEY": "your-api-key",
        "MCP_SEARCH_MODEL": "gemini-3-flash"
      }
    }
  }
}

As Python Library

import asyncio
from mcp_search import do_search

result = asyncio.run(do_search(
  query="latest AI news",
  model="gemini-3-flash"
))
print(result)

Tool Parameters

Parameter Type Required Description
query string ✅ Search keywords
model string ❌ Model ID (default: gemini-3-flash)

Requirements

License

MIT

Metadata

Release files for mcp-gemini-search 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-gemini-search 0.3.1
File Size Uploaded Provenance Actions
mcp_gemini_search-0.3.1.tar.gz 6.5 kB Without provenance Details for mcp_gemini_search-0.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcp-gemini-search 0.3.1
File Interpreter ABI Platform Actions
mcp_gemini_search-0.3.1-py3-none-any.whl Python 3 none any Details for mcp_gemini_search-0.3.1-py3-none-any.whl

Total release size: 13.0 kB

Release files / mcp_gemini_search-0.3.1.tar.gz

Download URL mcp_gemini_search-0.3.1.tar.gz
Size 6.5 kB
Tags Source
SHA-256 checksum
How to use checksums
af61ed172dbe02a8b06d3b51662aeea335edf5005876b7f6378448a2fb21b76d
BLAKE2b-256 checksum
How to use checksums
21c625c13e31a7de56138df7c0495f175f7016dc273f171bb0a3d79c84bce640
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.7

Release files / mcp_gemini_search-0.3.1-py3-none-any.whl

Download URL mcp_gemini_search-0.3.1-py3-none-any.whl
Size 6.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
821812b397ef49837767141857424fb200950f3627df5fc52ea30eb5026286e8
BLAKE2b-256 checksum
How to use checksums
486e8b04f096d7701655f9408b2ba62a05be8baaad3c69914d0bcecabfb9e1a1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.7

Security for mcp-gemini-search 0.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page