Mixelpixx GoogleSearch McpServer

🚀 Google Search MCP Server

A Model Context Protocol (MCP) server that provides Google search functionality and web content analysis tools. This server allows AI models to perform Google searches and analyze web content programmatically.

🚀 Quick Start

The Google Search MCP Server enables AI models to execute Google searches and analyze web - page content programmatically. Follow the steps below to get started.

✨ Features

• Integrate Google Custom Search
• Analyze web content
• Conduct batch web - page analysis
• Provide MCP - compatible interfaces

📦 Installation

Prerequisites

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

Steps

1. Clone the repository.
2. Install Node.js dependencies:

npm install

3. Install Python dependencies:

pip install flask google-api-python-client flask-cors

📚 Documentation

Configuration

1. Create an api-keys.json file in the root directory containing your Google API credentials:

{
    "api_key": "your-google-api-key",
    "search_engine_id": "your-custom-search-engine-id"
}

2. Add the server configuration to your MCP settings file (usually located at %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "google-search": {
      "command": "npm",
      "args": ["run", "start:all"],
      "cwd": "/path/to/google-search-server"
    }
  }
}

Build

npm run build

Run

Start both the TypeScript and Python servers simultaneously:

npm run start:all

Or run them separately:

• TypeScript server: npm start
• Python server: npm run start:python

Available Tools

1. Search

Perform a Google search and get results.

{
  "name": "search",
  "arguments": {
    "query": "your search query",
    "num_results": 5 // Optional, default: 5
  }
}

2. Analyze Webpage

Extract and analyze content from a single web page.

{
  "name": "analyze_webpage",
  "arguments": {
    "url": "https://example.com"
  }
}

3. Batch Analyze Webpages

Analyze multiple web pages in one request.

{
  "name": "batch_analyze_webpages",
  "arguments": {
    "urls": [
      "https://example1.com",
      "https://example2.com"
    ]
  }
}

Obtain Google API Credentials

1. Visit 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. Visit the Custom Search Engine page.
6. Create a new search engine and obtain your Search Engine ID.
7. Add these credentials to the api-keys.json file.

Error Handling

The server provides detailed error messages for the following situations:

• Missing or invalid API credentials
• Failed search requests
• Invalid web - page URLs
• Network connection issues

Architecture

The server consists of two main parts:

1. TypeScript MCP Server: Handles MCP protocol communication and provides tool interfaces.
2. Python Flask Server: Manages Google API interactions and web - content analysis.

📄 License

MIT