Deployed on Cloudflare Workers platform with KV namespace storage for OAuth authentication and session management.
Provides tools for performing Google searches and extracting webpage content, using Google Custom Search API to retrieve search results and convert webpages to readable text.
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
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 inspectorornpx @modelcontextprotocol/inspectorIn the Inspector interface, set the transport type to
SSE, URL tohttp://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
Available Tools
This server provides the following tools:
google_search - Perform Google searches and return results
extract_webpage_content - Extract webpage content and convert it to readable text
batch_extract_webpage_content - Batch extract content from multiple webpages
Connect to Claude Desktop
To connect Claude to your local MCP server:
Follow the Anthropic Quick Start Guide
In Claude Desktop, go to Settings > Developer > Edit Config
Replace the existing content with the following configuration:
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.
Deploy to Cloudflare
Create a KV namespace:
npx wrangler kv namespace create OAUTH_KVFollow the prompts to add the KV namespace ID to
wrangler.jsoncSet environment variables:
GOOGLE_API_KEY- Your Google API keyGOOGLE_SEARCH_ENGINE_ID- Your Google Custom Search Engine ID
Deploy:
npm run deploy
Connect to Remote MCP Server
After deployment, you can use MCP Inspector to connect to the remote server:
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:
Troubleshooting
If you encounter issues:
Restart Claude
Try connecting to the MCP server directly from the command line:
npx mcp-remote http://localhost:8787/sseClear the MCP authentication files:
rm -rf ~/.mcp-authCheck 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