Google Search Engine MCP Server

An MCP (Model Context Protocol) server based on Cloudflare Workers, providing Google search and webpage content extraction functionality with integrated OAuth login.

Local Development

# Clone the repository
git clone https://github.com/your-username/google-search-engine-mcp-server.git

# Install dependencies
cd google-search-engine-mcp-server
npm install

# Run locally
npm run dev

Visit http://localhost:8787/ to check the server status

Connect to MCP Inspector Testing Tool

Use the MCP Inspector to explore and test the API:

• Run npm run inspector or npx @modelcontextprotocol/inspector
• In the Inspector interface, set the transport type to SSE, URL to http://localhost:8787/sse, and click "Connect"
• Enter any email and password in the mock login interface
• After logging in, you can view and call all available tools

<div align="center"> <img src="img/mcp-inspector-sse-config.png" alt="MCP Inspector Configuration Interface" width="600"/> </div>

Available Tools

This server provides the following tools:

1. google_search - Perform Google searches and return results
2. extract_webpage_content - Extract webpage content and convert it to readable text
3. batch_extract_webpage_content - Batch extract content from multiple webpages

Connect to Claude Desktop

To connect Claude to your local MCP server:

1. Follow the Anthropic Quick Start Guide
2. In Claude Desktop, go to Settings > Developer > Edit Config
3. Replace the existing content with the following configuration:

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

After launching Claude, a browser window will open allowing you to log in. You can see available tools in the bottom right corner. With appropriate prompts, Claude will call the corresponding tools.

<div align="center"> <img src="img/available-tools.png" alt="Click the hammer icon to display the list of available tools" width="600"/> </div>

Deploy to Cloudflare

1. Create a KV namespace: npx wrangler kv namespace create OAUTH_KV
2. Follow the prompts to add the KV namespace ID to wrangler.jsonc
3. Set environment variables:
   • GOOGLE_API_KEY - Your Google API key
   • GOOGLE_SEARCH_ENGINE_ID - Your Google Custom Search Engine ID
4. Deploy: npm run deploy

Connect to Remote MCP Server

After deployment, you can use MCP Inspector to connect to the remote server:

npx @modelcontextprotocol/inspector@latest

Enter your Workers URL (e.g., your-worker-name.your-account.workers.dev/sse) as the MCP server address and click "Connect".

Connect Claude Desktop to Remote Server

Update the Claude configuration file to point to your Workers URL:

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-worker-name.your-account.workers.dev/sse"
      ]
    }
  }
}

Troubleshooting

If you encounter issues:

1. Restart Claude
2. Try connecting to the MCP server directly from the command line:

   npx mcp-remote http://localhost:8787/sse
   

3. Clear the MCP authentication files:

   rm -rf ~/.mcp-auth
   

4. Check console logs for detailed error information

Developer Notes

• This project is developed using TypeScript
• Based on Cloudflare Workers and Durable Objects
• Integrates OAuth authentication
• Uses Google Custom Search API for search functionality
• Includes webpage content extraction and analysis features