How do I install Kindly Web Search MCP Server?

Follow the setup instructions on the Kindly Web Search GitHub repository, then add the server configuration to your AI client.

What category is Kindly Web Search MCP Server?

Kindly Web Search is categorized under Search & Data Extraction. Browse more servers in these categories on MCPgee.

Kindly Web Search

Name: Kindly Web Search MCP Server
Author: Shelpuk-AI-Technology-Consulting

v1.0.0•Search & Data Extraction•stable

Kindly Web Search MCP Server: Web search + robust content retrieval for AI coding tools (Claude Code, Codex, Cursor, GitHub Copilot, Gemini, etc.) and AI agents (Claude Desktop, OpenClaw, etc.). Supports Serper, Tavily, and SearXNG.

aiai-agentsai-toolsclaude-codecodex

331

Stars

Downloads

Weekly

0/5

View on GitHub

What is Kindly Web Search?

Kindly Web Search is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to kindly web search mcp server: web search + robust content retrieval for ai coding tools (claude code, codex, cursor, github copilot, gemini, etc.) and ai agents (claude desktop, openclaw, etc.). suppo...

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

Kindly Web Search MCP Server: Web search + robust content re

Use Cases

Web search and content retrieval

Multi-engine support (Serper, Tavily)

AI coding tool integration

Shelpuk-AI-Technology-Consulting

Maintainer

LicenseMIT

Languagepython

Versionv1.0.0

UpdatedMay 20, 2026

Statushealthy

Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

View Source Browse All Servers

Installation

Manual Installation

npx kindly-web-search

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms

ThroughputMedium

Resource Usage

Memory UsageLow

CPU UsageLow

How to Set Up and Use Kindly Web Search

Kindly Web Search is an MCP server that combines web search with robust content retrieval optimized for AI coding assistants and agents. It supports three search backends — Serper, Tavily, and self-hosted SearXNG — and adds specialized extractors for StackOverflow, GitHub Issues, arXiv papers, and Wikipedia that return content in LLM-optimized Markdown rather than raw HTML. The two exposed tools (`web_search` and `get_content`) work seamlessly with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and Claude Desktop, making it a versatile research layer for any AI development workflow.

Prerequisites

Python 3.10+ and the uv package manager (install via: curl -LsSf https://astral.sh/uv/install.sh | sh)
At least one search provider API key: SERPER_API_KEY (serper.dev), TAVILY_API_KEY (tavily.com), or a self-hosted SearXNG instance URL
Chrome, Chromium, Edge, or Brave browser installed locally for page content extraction
An MCP client such as Claude Code, Claude Desktop, Cursor, or Codex
Optional: a GITHUB_TOKEN (read-only public repo scope) to improve GitHub Issue extraction quality

Install uv package manager

Kindly Web Search is run via uvx. Install uv on macOS/Linux with the script below, or on Windows use: irm https://astral.sh/uv/install.ps1 | iex in PowerShell.

curl -LsSf https://astral.sh/uv/install.sh | sh

Obtain a search provider API key

Sign up for a free or paid account at serper.dev to get a SERPER_API_KEY, or at tavily.com for a TAVILY_API_KEY. Alternatively, set up a self-hosted SearXNG instance and note its base URL.

Verify your browser is auto-detected

The server uses a local browser (Chrome, Chromium, Edge, or Brave) to fetch full page content. If auto-detection fails, set KINDLY_BROWSER_EXECUTABLE_PATH to the browser binary path.

export KINDLY_BROWSER_EXECUTABLE_PATH=/usr/bin/chromium-browser

Add the server to your MCP client

For Claude Code, use the CLI to register the server with your API key as an environment variable. Adjust the search provider environment variable based on which backend you chose.

claude mcp add --transport stdio kindly-web-search \
  -e SERPER_API_KEY="$SERPER_API_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  -- uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server \
  kindly-web-search-mcp-server start-mcp-server

Restart your MCP client and test

Restart Claude Code or Claude Desktop to load the new server. Ask the AI to search for something to confirm both search and content retrieval are working.

Kindly Web Search Examples

Client configuration

Add this block to your claude_desktop_config.json to use Kindly Web Search with the Serper backend.

{
  "mcpServers": {
    "kindly-web-search": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server",
        "kindly-web-search-mcp-server",
        "start-mcp-server"
      ],
      "env": {
        "SERPER_API_KEY": "your_serper_api_key_here",
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

Prompts to try

These prompts use the web_search and get_content tools to research documentation, issues, and technical content.

- "Search for the latest Python asyncio best practices and summarize the top results"
- "Find the GitHub issue tracking the asyncio timeout bug in aiohttp and show me the discussion"
- "Search arXiv for recent papers on retrieval-augmented generation published in 2024"
- "Look up the StackOverflow answer for how to handle CORS in FastAPI and explain it to me"
- "Get the full content from https://docs.python.org/3/library/asyncio.html and summarize the key concepts"

Troubleshooting Kindly Web Search

web_search returns an error about missing API key

Ensure SERPER_API_KEY, TAVILY_API_KEY, or SEARXNG_BASE_URL is set in the env block of your MCP config. Only one search provider is needed, but at least one must be configured.

get_content fails to load pages or returns empty content

Confirm a supported browser (Chrome, Chromium, Edge, or Brave) is installed. If auto-detection fails, set KINDLY_BROWSER_EXECUTABLE_PATH to the full path of the browser binary in your MCP server env config.

GitHub Issues content is truncated or missing detail

Add a GITHUB_TOKEN environment variable with at least read-only public repo scope. Without this token, the server falls back to unauthenticated GitHub API requests, which are rate-limited and may return incomplete data.

Frequently Asked Questions about Kindly Web Search

What is Kindly Web Search?

Kindly Web Search is a Model Context Protocol (MCP) server that kindly web search mcp server: web search + robust content retrieval for ai coding tools (claude code, codex, cursor, github copilot, gemini, etc.) and ai agents (claude desktop, openclaw, etc.). supports serper, tavily, and searxng. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Kindly Web Search?

Follow the installation instructions on the Kindly Web Search GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Kindly Web Search?

Kindly Web Search works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Kindly Web Search free to use?

Yes, Kindly Web Search is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Kindly Web Search Alternatives — Similar Search & Data Extraction Servers

Looking for alternatives to Kindly Web Search? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.

TrendRadar

★ 58.0k

A real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va

Scrapling

★ 52.7k

🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!

PDF Math Translate

★ 33.9k

[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero

GPT Researcher

★ 27.2k

An autonomous agent that conducts deep research on any data using any LLM providers

Agent Reach

★ 20.1k

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

Xiaohongshu

★ 13.7k

MCP for xiaohongshu.com

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Search & Data Extraction Browse All Servers

Set Up Kindly Web Search in Your Editor

Choose your AI client for step-by-step setup instructions.

🖥️

Claude Desktop

macOS & Windows app

⌨️

Claude Code

CLI & terminal

📝

Cursor

AI-first code editor

💻

VS Code

GitHub Copilot MCP

🏄

Windsurf

Codeium AI editor

🔌

Cline

VS Code extension

Quick Config Preview

{
  "mcpServers": {
    "kindly-web-search": {
      "command": "npx",
      "args": ["-y", "kindly-web-search"]
    }
  }
}

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Kindly Web Search?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides

Explore All Servers Read Our Guides