web-search

web-search

A Model Context Protocol server enabling web search via Google without API keys.

277
Stars
96
Forks
277
Watchers
6
Issues
Web Search MCP Server is a Model Context Protocol server that enables free web searching through Google by scraping public search results, bypassing the need for API keys or authentication. It returns structured search results including titles, URLs, and descriptions, and allows users to configure the number of results per query. Designed to integrate easily with various MCP-compatible tools, it offers straightforward configuration for development environments like VSCode and Claude Desktop. The tool is intended for personal use and implements rate limiting guidance to comply with responsible usage.

Key Features

Google search results scraping
No API key or authentication needed
Returns structured JSON results
Configurable number of results per query
Single tool interface named 'search'
Integration with VSCode and Claude Desktop via MCP
Easy command-line setup and configuration
Supports optional result limits per search
Detailed error and limitation documentation
Open for enhancement and issue submission

Use Cases

On-demand web search integration in AI assistants
Enhancing developer workflow with quick web lookups
Incorporating latest web data into model context
Providing research results in applications without cost
Rapid prototyping for AI tools needing live web information
Personal knowledge augmentation via search automation
Data enrichment for chatbots and language models
Testing context-aware model features using web data
Lightweight search for desktop AI tools
Context injection during code or document generation

README

Web Search MCP Server

A Model Context Protocol (MCP) server that enables free web searching using Google search results, with no API keys required.

Features

  • Search the web using Google search results
  • No API keys or authentication required
  • Returns structured results with titles, URLs, and descriptions
  • Configurable number of results per search

Installation

  1. Clone or download this repository
  2. Install dependencies:
bash
npm install
  1. Build the server:
bash
npm run build
  1. Add the server to your MCP configuration:

For VSCode (Claude Dev Extension):

json
{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
    }
  }
}

For Claude Desktop:

json
{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
    }
  }
}

Usage

The server provides a single tool named search that accepts the following parameters:

typescript
{
  "query": string,    // The search query
  "limit": number     // Optional: Number of results to return (default: 5, max: 10)
}

Example usage:

typescript
use_mcp_tool({
  server_name: "web-search",
  tool_name: "search",
  arguments: {
    query: "your search query",
    limit: 3  // optional
  }
})

Example response:

json
[
  {
    "title": "Example Search Result",
    "url": "https://example.com",
    "description": "Description of the search result..."
  }
]

Limitations

Since this tool uses web scraping of Google search results, there are some important limitations to be aware of:

  1. Rate Limiting: Google may temporarily block requests if too many searches are performed in a short time. To avoid this:

    • Keep searches to a reasonable frequency
    • Use the limit parameter judiciously
    • Consider implementing delays between searches if needed
  2. Result Accuracy:

    • The tool relies on Google's HTML structure, which may change
    • Some results might be missing descriptions or other metadata
    • Complex search operators may not work as expected
  3. Legal Considerations:

    • This tool is intended for personal use
    • Respect Google's terms of service
    • Consider implementing appropriate rate limiting for your use case

Contributing

Feel free to submit issues and enhancement requests!

Star History

Star History Chart

Repository Owner

pskill9
pskill9

User

Repository Details

Language JavaScript
Default Branch main
Size 9 KB
Contributors 1
MCP Verified Sep 5, 2025

Programming Languages

JavaScript
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • cloudflare/mcp-server-cloudflare

    cloudflare/mcp-server-cloudflare

    Connect Cloudflare services to Model Context Protocol (MCP) clients for AI-powered management.

    Cloudflare MCP Server enables integration between Cloudflare's suite of services and clients using the Model Context Protocol (MCP). It provides multiple specialized servers that allow AI models to access, analyze, and manage configurations, logs, analytics, and other features across Cloudflare's platform. Users can leverage natural language interfaces in compatible MCP clients to read data, gain insights, and perform automated actions on their Cloudflare accounts. This project aims to streamline the orchestration of security, development, monitoring, and infrastructure tasks through standardized MCP connections.

    • 2,919
    • MCP
    • cloudflare/mcp-server-cloudflare
  • awslabs/mcp

    awslabs/mcp

    Specialized MCP servers for seamless AWS integration in AI and development environments.

    AWS MCP Servers is a suite of specialized servers implementing the open Model Context Protocol (MCP) to bridge large language model (LLM) applications with AWS services, tools, and data sources. It provides a standardized way for AI assistants, IDEs, and developer tools to access up-to-date AWS documentation, perform cloud operations, and automate workflows with context-aware intelligence. Featuring a broad catalog of domain-specific servers, quick installation for popular platforms, and both local and remote deployment options, it enhances cloud-native development, infrastructure management, and workflow automation for AI-driven tools. The project includes Docker, Lambda, and direct integration instructions for environments such as Amazon Q CLI, Cursor, Windsurf, Kiro, and VS Code.

    • 6,220
    • MCP
    • awslabs/mcp
  • k8s-mcp-server

    k8s-mcp-server

    Securely enable Claude to run Kubernetes CLI tools via Anthropic's Model Context Protocol.

    K8s MCP Server provides a Docker-based implementation of Anthropic's Model Context Protocol (MCP), allowing Claude to securely execute Kubernetes CLI tools such as kubectl, helm, istioctl, and argocd within a containerized environment. It integrates with Claude Desktop so users can interact with their Kubernetes clusters using natural language. The server emphasizes security by operating as a non-root user and offering strict command validation, while also supporting major cloud providers like AWS, Google Cloud, and Azure. Easy configuration and support for various Unix tools further enhance its capabilities.

    • 166
    • MCP
    • alexei-led/k8s-mcp-server
  • mcpmcp-server

    mcpmcp-server

    Seamlessly discover, set up, and integrate MCP servers with AI clients.

    mcpmcp-server enables users to discover, configure, and connect MCP servers with preferred clients, optimizing AI integration into daily workflows. It supports streamlined setup via JSON configuration, ensuring compatibility with various platforms such as Claude Desktop on macOS. The project simplifies the connection process between AI clients and remote Model Context Protocol servers. Users are directed to an associated homepage for further platform-specific guidance.

    • 17
    • MCP
    • glenngillen/mcpmcp-server
  • mcp

    mcp

    Universal remote MCP server connecting AI clients to productivity tools.

    WayStation MCP acts as a remote Model Context Protocol (MCP) server, enabling seamless integration between AI clients like Claude or Cursor and a wide range of productivity applications, such as Notion, Monday, Airtable, Jira, and more. It supports multiple secure connection transports and offers both general and user-specific preauthenticated endpoints. The platform emphasizes ease of integration, OAuth2-based authentication, and broad app compatibility. Users can manage their integrations through a user dashboard, simplifying complex workflow automations for AI-powered productivity.

    • 27
    • MCP
    • waystation-ai/mcp
  • OpenMCP

    OpenMCP

    A standard and registry for converting web APIs into MCP servers.

    OpenMCP defines a standard for converting various web APIs into servers compatible with the Model Context Protocol (MCP), enabling efficient, token-aware communication with client LLMs. It also provides an open-source registry of compliant servers, allowing clients to access a wide array of external services. The platform supports integration with local and remote hosting environments and offers tools for configuring supported clients, such as Claude desktop and Cursor. Comprehensive guidance is offered for adapting different API formats including REST, gRPC, GraphQL, and more into MCP endpoints.

    • 252
    • MCP
    • wegotdocs/open-mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results