Google Search MCP Server

Integrations

  • Provides Google search capabilities to AI models through an MCP server interface, allowing for advanced search queries with filtering options for date, language, country, and safe search

  • Integrates with Google Cloud Platform for API credentials and Custom Search capabilities needed to power the Google search functionality

Version 2.0 is here!!

NEWS - my NEW 'KiCAD MCP Server' is here, along with this 'Google Search MCP Server' they are a powerful duo!

https://github.com/mixelpixx/KiCAD-MCP-Server

Google Search MCP Server

An MCP (Model Context Protocol) server that provides Google search capabilities and webpage content analysis tools. This server enables AI models to perform Google searches and analyze webpage content programmatically.

Features

  • Google Custom Search integration
  • Advanced search features (filters, sorting, pagination, categorization)
  • Webpage content analysis in multiple formats (markdown, HTML, plain text)
  • Batch webpage analysis
  • Result categorization and classification
  • Content summarization
  • Optimized, human-readable responses
  • MCP-compliant interface

Prerequisites

  • Node.js (v16 or higher)
  • Google Cloud Platform account
  • Custom Search Engine ID
  • Google API Key

Installation

  1. Clone the repository
  2. Install Node.js dependencies:
npm install
  1. Build the TypeScript code:
npm run build

Configuration

  1. Set up environment variables for your Google API credentials:

You can either set these as system environment variables or configure them in your MCP settings file.

Required environment variables:

  • GOOGLE_API_KEY: Your Google API key
  • GOOGLE_SEARCH_ENGINE_ID: Your Custom Search Engine ID
  1. Add the server configuration to your MCP settings file (typically located at %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):
{ "mcpServers": { "google-search": { "autoApprove": [ "google_search", "extract_webpage_content", "extract_multiple_webpages" ], "disabled": false, "timeout": 60, "command": "node", "args": [ "/path/to/google-search-mcp-server/dist/google-search.js" ], "env": { "GOOGLE_API_KEY": "your-google-api-key", "GOOGLE_SEARCH_ENGINE_ID": "your-custom-search-engine-id" }, "transportType": "stdio" } } }

Running

Start the MCP server:

npm run start

Available Tools

Search Google and return relevant results from the web. This tool finds web pages, articles, and information on specific topics using Google's search engine.

{ "name": "google_search", "arguments": { "query": "your search query", "num_results": 5, // optional, default: 5 "site": "example.com", // optional, limit results to specific website "language": "en", // optional, filter by language (ISO 639-1 code) "dateRestrict": "m6", // optional, filter by date (e.g., "m6" for last 6 months) "exactTerms": "exact phrase", // optional, search for exact phrase "resultType": "news", // optional, specify type (news, images, videos) "page": 2, // optional, page number for pagination (starts at 1) "resultsPerPage": 10, // optional, results per page (max: 10) "sort": "date" // optional, sort by "date" or "relevance" (default) } }

Response includes:

  • Search results with title, link, snippet in a readable format
  • Pagination information (current page, total results, etc.)
  • Categories of results (automatically detected)
  • Navigation hints for pagination

2. extract_webpage_content

Extract and analyze content from a webpage, converting it to readable text. This tool fetches the main content while removing ads, navigation elements, and other clutter.

{ "name": "extract_webpage_content", "arguments": { "url": "https://example.com", "format": "markdown" // optional, format options: "markdown" (default), "html", or "text" } }

Response includes:

  • Title and description of the webpage
  • Content statistics (word count, character count)
  • Content summary
  • Content preview (first 500 characters)

3. extract_multiple_webpages

Extract and analyze content from multiple webpages in a single request. Ideal for comparing information across different sources or gathering comprehensive information on a topic.

{ "name": "extract_multiple_webpages", "arguments": { "urls": [ "https://example1.com", "https://example2.com" ], "format": "html" // optional, format options: "markdown" (default), "html", or "text" } }

Response includes:

  • Title and description of each webpage
  • Content statistics for each webpage
  • Content summary for each webpage
  • Content preview for each webpage (first 150 characters)

Getting Google API Credentials

  1. Go to the Google Cloud Console
  2. Create a new project or select an existing one
  3. Enable the Custom Search API
  4. Create API credentials (API Key)
  5. Go to the Custom Search Engine page
  6. Create a new search engine and get your Search Engine ID
  7. Add these credentials to your MCP settings file or set them as environment variables

Error Handling

The server provides detailed error messages for:

  • Missing or invalid API credentials
  • Failed search requests
  • Invalid webpage URLs
  • Network connectivity issues

Architecture

The server is built with TypeScript and uses the MCP SDK to provide a standardized interface for AI models to interact with Google Search and webpage content analysis tools. It consists of two main services:

  1. GoogleSearchService: Handles Google API interactions for search functionality
  2. ContentExtractor: Manages webpage content analysis and extraction

The server uses caching mechanisms to improve performance and reduce API calls.

Distributing the Built Version

If you prefer to distribute only the built version of this tool rather than the source code, you can follow these steps:

  1. Build the TypeScript code:
npm run build
  1. Create a distribution package with only the necessary files:
# Create a distribution directory mkdir -p dist-package # Copy the compiled JavaScript files cp -r dist dist-package/ # Copy package files (without dev dependencies) cp package.json dist-package/ cp README.md dist-package/ # Create a simplified package.json for distribution node -e "const pkg = require('./package.json'); delete pkg.devDependencies; delete pkg.scripts.build; delete pkg.scripts.dev; pkg.scripts.start = 'node dist/google-search.js'; require('fs').writeFileSync('dist-package/package.json', JSON.stringify(pkg, null, 2));"
  1. Users can then install and run the built version:
# Install production dependencies only npm install --production # Start the server npm start

This approach allows you to distribute the compiled JavaScript files without exposing the TypeScript source code. Users will still need to:

  1. Configure their Google API credentials as environment variables
  2. Add the server configuration to their MCP settings file
  3. Install the production dependencies

Note that the package.json in the distribution will only include production dependencies and a simplified set of scripts.

License

MIT

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

An MCP (Model Context Protocol) server that provides Google search capabilities and webpage content analysis tools. This server enables AI models to perform Google searches and analyze webpage content programmatically.

  1. NEWS - my NEW 'KiCAD MCP Server' is here, along with this 'Google Search MCP Server' they are a powerful duo!
    1. Google Search MCP Server
      1. Features
      2. Prerequisites
      3. Installation
      4. Configuration
      5. Running
      6. Available Tools
      7. Getting Google API Credentials
      8. Error Handling
      9. Architecture
      10. Distributing the Built Version
      11. License

    Related MCP Servers

    • A
      security
      A
      license
      A
      quality
      A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
      Last updated -
      1
      1,832
      1,497
      TypeScript
      MIT License
      • Apple
    • A
      security
      A
      license
      A
      quality
      A Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.
      Last updated -
      2
      26
      Python
      MIT License
      • Apple
    • A
      security
      F
      license
      A
      quality
      Built as a Model Context Protocol (MCP) server that provides advanced web search, content extraction, web crawling, and scraping capabilities using the Firecrawl API.
      Last updated -
      4
      1
      Python
      • Apple
      • Linux
    • A
      security
      F
      license
      A
      quality
      An MCP protocol server that enables web search functionality using the Tavily API, allowing AI assistants to perform internet searches in real-time.
      Last updated -
      4
      2
      Python

    View all related MCP servers

    ID: 8m8reyzrcd