# Kindly Web Search MCP Server (MCP server)

> Kindly Web Search MCP Server is an MCP server that adds search and knowledge tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Kindly Web Search MCP Server: Web… It has 396 GitHub stars, is released under the MIT license and runs locally with docker run -i --rm -e SERPER_API_KEY -e TAVILY_API_KEY -e GITHUB_TOKEN ghcr.io/shelpuk-ai-technology-consulting/kindly-web-search-mcp-server.

Web search + robust content retrieval for AI coding tools. Kindly Web Search is a part of the Shelpuk AI Technology Consulting agentic suite – a set of tools that together improve the code quality produced by AI coding agents by 15–20%. Read more on Claude Code generation quality improvement.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server |
| GitHub stars | 396 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | docker: ghcr.io/shelpuk-ai-technology-consulting/kindly-web-search-mcp-server |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | AI & search |
| Latest release | none |
| Last commit | Sep 28, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "kindly-web-search-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SERPER_API_KEY",
        "-e",
        "TAVILY_API_KEY",
        "-e",
        "GITHUB_TOKEN",
        "ghcr.io/shelpuk-ai-technology-consulting/kindly-web-search-mcp-server"
      ],
      "env": {
        "SERPER_API_KEY": "your-value",
        "TAVILY_API_KEY": "your-value",
        "GITHUB_TOKEN": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env SERPER_API_KEY=your-value --env TAVILY_API_KEY=your-value --env GITHUB_TOKEN=your-value --transport stdio kindly-web-search-mcp-server -- docker run -i --rm -e SERPER_API_KEY -e TAVILY_API_KEY -e GITHUB_TOKEN ghcr.io/shelpuk-ai-technology-consulting/kindly-web-search-mcp-server
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "kindly-web-search-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SERPER_API_KEY",
        "-e",
        "TAVILY_API_KEY",
        "-e",
        "GITHUB_TOKEN",
        "ghcr.io/shelpuk-ai-technology-consulting/kindly-web-search-mcp-server"
      ],
      "env": {
        "SERPER_API_KEY": "your-value",
        "TAVILY_API_KEY": "your-value",
        "GITHUB_TOKEN": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "serper_api_key",
      "description": "SERPER_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "tavily_api_key",
      "description": "TAVILY_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "github_token",
      "description": "GITHUB_TOKEN",
      "password": true
    }
  ],
  "servers": {
    "kindly-web-search-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SERPER_API_KEY",
        "-e",
        "TAVILY_API_KEY",
        "-e",
        "GITHUB_TOKEN",
        "ghcr.io/shelpuk-ai-technology-consulting/kindly-web-search-mcp-server"
      ],
      "env": {
        "SERPER_API_KEY": "${input:serper_api_key}",
        "TAVILY_API_KEY": "${input:tavily_api_key}",
        "GITHUB_TOKEN": "${input:github_token}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `SERPER_API_KEY` (secret): Shown in the README's example configuration.
- `TAVILY_API_KEY` (secret): Shown in the README's example configuration.
- `SEARXNG_BASE_URL`: Shown in the README's example configuration.
- `GITHUB_TOKEN` (secret): Shown in the README's example configuration.
- `KINDLY_BROWSER_EXECUTABLE_PATH`: Shown in the README's example configuration.

## Similar MCP servers

- [Context7](https://appsgit.com/mcp-servers/context7): Up-to-date code docs for any prompt. (62,752 stars, MIT, needs API key)
- [FunASR](https://appsgit.com/mcp-servers/funasr): Transcribe local audio with FunASR and SenseVoice using private, on-device inference. (20,596 stars, MIT)
- [Bifrost](https://appsgit.com/mcp-servers/bifrost): Fastest enterprise AI gateway (50x faster than LiteLLM) with adaptive load balancer, cluster mode, guardrails, 1000+ models support & <100 µs overhead at 5k RPS. (8,591 stars, Apache-2.0)
- [Honcho](https://appsgit.com/mcp-servers/honcho): Memory that reasons: continual learning for stateful agents. (7,494 stars, AGPL-3.0, needs API key)
- [Semble](https://appsgit.com/mcp-servers/semble): Fast and Accurate Code Search for Agents. (6,185 stars, MIT)
- [Exa](https://appsgit.com/mcp-servers/exa): Connect AI agents to Exa for web search, content fetching, and multi-step research. (5,088 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/kindly-web-search-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.