kindly-web-search-mcp-server

MCP搜索检索

提供方 Shelpuk-AI-Technology-Consulting · 包名 kindly-web-search-mcp-server

搜索检索 stdio · 本地进程 未标注 社区 / 第三方 Claude DesktopCursorClineClaude Code
查看接入方式

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

一句话选型结论

按资料字段整理

kindly-web-search-mcp-server 属于搜索检索类 MCP 服务器,stdio · 本地进程,鉴权方式未标注,可直接接入 Claude Desktop、Cursor、Cline 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式stdio · 本地进程 鉴权未标注 部署方式本地部署
GitHub 星标 272 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

kindly-web-search-mcp-server ai ai-agents ai-tools claude-code

支持客户端

适用场景

kindly-web-search-mcp-serveraiai-agents

安装与配置

stdio · 本地进程 未标注
客户端在本机拉起子进程,数据不出本机
pip install kindly-web-search-mcp-server

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Cross-platform,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Cursor、Cline,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
kindly-web-search-mcp-server当前 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Shelpuk-AI-Technology-Consulting上游标注的维护方 Shelpuk-AI-Technology-Consulting
分类搜索检索本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时kindly-web-search-mcp-server · Cross-platform本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-04-11上游最后核验时间

详细介绍

39.2 KB
来自项目仓库与上游目录的原文,未做删改

Improve AI-generated code quality by 20%

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.

Works with Claude Code, Codex, Antigravity, Cursor, Windsurf, and any agent that supports skills or MCP servers.

Component Role
tdd Enforces TDD, requirements discipline, and peer review for every coding task
Serena Semantic code navigation + persistent project memory
Kindly Web Search ← you are here Up-to-date API and package documentation via web search
Lad MCP Server Project-aware AI design and code review

If you like what we're building, please ⭐ star this repo – it's a huge motivation for us to keep going!

How to use the suite

1. Install three MCP servers and one skill:

  • Serena
  • Kindly Web Search
  • Lad MCP Server
  • tdd

2. Use the skill when requesting a feature:

Prompt your favorite AI coding agent (Claude Code, Codex, Cursor, etc.) as usual. Then just add Follow $tdd in the end.```
> Build [your feature description]. Follow $tdd.


# Kindly Web Search MCP Server

## Why do we need another web search MCP server?

Picture this: You're debugging a cryptic error in Google Cloud Batch with GPU instances. Your AI coding assistant searches the web and finds the *perfect* StackOverflow thread. Great, right? Not quite. Here's what most web search MCP servers give your AI:```json
{
  "title": "GCP Cloud Batch fails with the GPU instance template",
  "url": "https://stackoverflow.com/questions/76546453/...",
  "snippet": "I am trying to run a GCP Cloud Batch job with K80 GPU. The job runs for ~30 min. and then fails..."
}

The question is there, but where are the answers? Where are the solutions that other developers tried? The workarounds? The "this worked for me" comments?

They're not there. Your AI now has to make a second call to scrape the page. Sometimes it does, sometimes it doesn't. And even when it does, most scrapers return either incomplete content or the entire webpage with navigation panels, ads, and other noise that wastes tokens and confuses the AI.

The Real Problem

At Shelpuk AI Technology Consulting, we build custom AI products under a fixed-price model. Development efficiency isn't just nice to have - it's the foundation of our business. We've been using AI coding assistants since 2023 (GitHub Copilot, Cursor, Windsurf, Claude Code, Codex), and we noticed something frustrating:

When we developers face a complex bug, we don't just want to find a URL - we want to find the conversation. We want to see what others tried, what worked, what didn't, and why. We want the GitHub Issue with all the comments. We want the StackOverflow thread with upvoted answers and follow-up discussions. We want the arXiv paper content, not just its abstract.

Existing web search MCP servers are basically wrappers around search APIs. They're great at finding content, but terrible at delivering it in a way that's useful for AI coding assistants.

What Kindly Does Differently

We built Kindly Web Search because we needed our AI assistants to work the way we work. When searching for solutions, Kindly:

✅ Integrates directly with APIs for StackExchange, GitHub Issues, arXiv, and Wikipedia - presenting content in LLM-optimized formats with proper structure

✅ Returns the full conversation in a single call: questions, answers, comments, reactions, and metadata

✅ Parses any webpage in real-time using a headless browser for cutting-edge issues that were literally posted yesterday

✅ Passes all useful content to the LLM immediately - no need for a second scraping call

✅ Supports multiple search providers (Serper, SerpBase, Tavily, SearXNG, Sofya, You.com, and Serply) with intelligent fallback

Now, when Claude Code or Codex searches for that GPU batch error, it gets the question and the answers. The code snippets. The "this fixed it for me" comments. Everything it needs to help you solve the problem - in one call.

If you give Kindly a try or like the idea, please drop us a star on GitHub - it’s always huge motivation for us to keep improving it! ⭐️

One MCP Server to Rule Them All

Kindly eliminates the need for:

✅ Generic web search MCP servers

✅ StackOverflow MCP servers

✅ Web scraping MCP servers (Playwright, Puppeteer, etc.)

It also significantly reduces reliance on GitHub MCP servers by providing structured Issue content through intelligent extraction.

Kindly has been our daily companion in production work for months, saving us countless hours and improving the effectiveness of our AI coding assistants. We're excited to share it with the community!

Tools

  • web_search(query, num_results=3) → top results with title, link, snippet, and page_content (Markdown, best-effort).
  • get_content(url) → page_content (Markdown, best-effort).

Content resolver

When extracting page content (get_content or web_search results), Kindly routes each URL through a priority chain of specialized handlers before falling back to the universal HTML loader:

Priority Target Handler HTTP client Proxy support
1 StackExchange (StackOverflow, etc.) StackExchange API httpx[socks] HTTP_PROXY / HTTPS_PROXY / ALL_PROXY (HTTP, SOCKS5)
2 GitHub Issues GitHub GraphQL API httpx[socks] HTTP_PROXY / HTTPS_PROXY / ALL_PROXY (HTTP, SOCKS5)
3 GitHub Discussions GitHub GraphQL API httpx[socks] HTTP_PROXY / HTTPS_PROXY / ALL_PROXY (HTTP, SOCKS5)
4 Wikipedia MediaWiki Action API httpx[socks] HTTP_PROXY / HTTPS_PROXY / ALL_PROXY (HTTP, SOCKS5)
5 arXiv Atom API + PDF → Markdown httpx[socks] HTTP_PROXY / HTTPS_PROXY / ALL_PROXY (HTTP, SOCKS5)
6 All other URLs Universal HTML loader headless Chromium (nodriver) KINDLY_CHROME_PROXY (HTTP, SOCKS5, etc.)

All httpx-based handlers read standard proxy environment variables (HTTP_PROXY, HTTPS_PROXY, ALL_PROXY) and support both HTTP and SOCKS proxy URLs via the socksio dependency. The universal HTML loader uses Chromium's --proxy-server flag via KINDLY_CHROME_PROXY, which supports SOCKS5 and other schemes natively.

Search uses Serper (primary, if configured), SerpBase, Tavily, SearXNG, Sofya, You.com, or Serply, and page extraction uses a local Chromium-based browser via nodriver.

Markdown fast paths (skip the browser for doc sites)

Before launching the headless browser, the universal HTML loader first tries to fetch markdown directly with one cheap httpx GET — returning it immediately on a hit and falling back to the browser unchanged on any miss. Two independent probes:

Probe Env var Default Mechanism
Suffix KINDLY_MARKDOWN_SUFFIX_HOSTS help.aliyun.com,www.alibabacloud.com/help (on) For listed hosts, request {path}.md — Aliyun docs serve text/markdown at that route. Add host or host/path-prefix entries for other {path}.md sites.
Accept KINDLY_MARKDOWN_ACCEPT_PROBE 0 (off) Set to 1 to request every universal-path URL with Accept: text/markdown. Catches supporters automatically (Cloudflare, Microsoft Learn, AWS, GitHub, … per acceptmarkdown.com); on text/html the browser re-fetches (one extra request).

Both probes validate the response (text/markdown, ≥1 KB, non-empty after sanitize) and apply the same output cap as the browser path, so the returned markdown is consistent across paths. See .env.example for the full entries.

Requirements

  • A search provider (priority order): SERPER_API_KEY (recommended) → SERPBASE_API_KEY (SerpBase, Google results) → TAVILY_API_KEY → SEARXNG_BASE_URL (self-hosted SearXNG) → SOFYA_API_KEY → YDC_API_KEY (You.com) → SERPLY_API_KEY (Serply) → APIFARE_TOKEN (apifare, prepaid balance)
  • A Chromium-based browser installed on the same machine running the MCP client (Chrome/Chromium/Edge/Brave)
  • Without a browser: specialized sources (StackExchange, GitHub Issues/Discussions, Wikipedia, arXiv) still work well, but universal HTML page_content extraction may fail for other sites.
  • Highly recommended: GITHUB_TOKEN (renders GitHub Issues in a much more LLM-friendly format: question + answers/comments + reactions/metadata; fewer rate limits)
  • Python 3.13+ is supported (Python 3.14 supported; optional “advanced PDF layout” extras are disabled on 3.14 because onnxruntime wheels may be unavailable).

GITHUB_TOKEN can be read-only and limited to public repositories to avoid security/privacy concerns.

Quickstart

1) Install uvx

macOS / Linux:```bash
curl -LsSf https://astral.sh/uv/install.sh | sh


Windows (PowerShell):```powershell
irm https://astral.sh/uv/install.ps1 | iex

Re-open your terminal and verify:```bash
uvx --version


### 2) Install a Chromium-based browser (required for `page_content`)

You need **Chrome / Chromium / Edge / Brave** installed on the same machine running your MCP client.

Note: If you skip this, specialized sources (StackOverflow/StackExchange, GitHub Issues/Discussions, Wikipedia, arXiv) will still work well. Only universal `page_content` extraction for arbitrary sites requires the browser.

macOS:

- Install Chrome, or:```bash
brew install --cask chromium

Windows:

  • Install Chrome or Edge.
  • If browser auto-detection fails later, you’ll need the path:```powershell
    Get-Command chrome | Select-Object -ExpandProperty Source

Common path:

C:\Program Files\Google\Chrome\Application\chrome.exe

If Get-Command chrome fails, try one of these:

C:\Program Files (x86)\Google\Chrome\Application\chrome.exe

C:\Program Files\Microsoft\Edge\Application\msedge.exe


Linux (Ubuntu/Debian):```bash
sudo apt-get update
sudo apt-get install -y chromium
which chromium

Other Linux distros: install chromium (or chromium-browser) via your package manager.

3) Set your search API key (required)

Set one of these. Provider selection order is: Serper → SerpBase → Tavily → SearXNG → Sofya → You.com → Serply.

macOS / Linux:```bash
export SERPER_API_KEY="..."

or:

export TAVILY_API_KEY="..."

or (You.com, key at https://you.com/platform/api-keys):

export YDC_API_KEY="..."

or (Serply, key at https://serply.io):

export SERPLY_API_KEY="..."

or

export APIFARE_TOKEN="..."

or (self-hosted SearXNG):

export SEARXNG_BASE_URL="https://searx.example.org"


Windows (PowerShell):```powershell
$env:SERPER_API_KEY="..."
# or:
$env:TAVILY_API_KEY="..."
# or (You.com, key at https://you.com/platform/api-keys):
$env:YDC_API_KEY="..."
# or (Serply, key at https://serply.io):
$env:SERPLY_API_KEY="..."
# or
$env:APIFARE_TOKEN="..."
# or (self-hosted SearXNG):
$env:SEARXNG_BASE_URL="https://searx.example.org"

Optional (SearXNG): if your instance requires authentication or blocks bots, set:```bash
export SEARXNG_HEADERS_JSON='{"Authorization":"Bearer ..."}'
export SEARXNG_USER_AGENT="Mozilla/5.0 ..."


Windows (PowerShell):```powershell
$env:SEARXNG_HEADERS_JSON='{"Authorization":"Bearer ..."}'
$env:SEARXNG_USER_AGENT="Mozilla/5.0 ..."

Optional (recommended for better GitHub Issue / PR extraction):```bash
export GITHUB_TOKEN="..."


For public repos, a read-only token is enough (classic tokens often use `public_repo`; fine-grained tokens need repo read access).

### 4) Run command used by all MCP clients```bash
uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server \
  kindly-web-search-mcp-server start-mcp-server

First-run note: the first uvx invocation may take 30–60 seconds while it builds the tool environment. If your MCP client times out on first start, run the command once in a terminal to “prewarm” it, then retry in your client.

Now configure your MCP client to run that command.
Make sure your API keys are set in the same shell/OS environment that launches the MCP client (unless you paste them directly into the client config).

Client setup

Codex

Set one of SERPER_API_KEY, SERPBASE_API_KEY, TAVILY_API_KEY, SEARXNG_BASE_URL, SOFYA_API_KEY, YDC_API_KEY, SERPLY_API_KEY, or APIFARE_TOKEN.

CLI (no file editing) — add a local stdio MCP server:

macOS / Linux (Serper):```bash
codex mcp add kindly-web-search \
--env SERPER_API_KEY="$SERPER_API_KEY" \
--env GITHUB_TOKEN="$GITHUB_TOKEN" \
--env KINDLY_BROWSER_EXECUTABLE_PATH="$KINDLY_BROWSER_EXECUTABLE_PATH" \
-- uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server \
kindly-web-search-mcp-server start-mcp-server


macOS / Linux (Tavily):```bash
codex mcp add kindly-web-search \
  --env TAVILY_API_KEY="$TAVILY_API_KEY" \
  --env GITHUB_TOKEN="$GITHUB_TOKEN" \
  --env KINDLY_BROWSER_EXECUTABLE_PATH="$KINDLY_BROWSER_EXECUTABLE_PATH" \
  -- uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server \
  kindly-web-search-mcp-server start-mcp-server

If you use SearXNG, replace the provider env var above with:```bash
--env SEARXNG_BASE_URL="$SEARXNG_BASE_URL"


Windows (PowerShell):```powershell
codex mcp add kindly-web-search `
  --env SERPER_API_KEY="$env:SERPER_API_KEY" `
  --env GITHUB_TOKEN="$env:GITHUB_TOKEN" `
  --env KINDLY_BROWSER_EXECUTABLE_PATH="$env:KINDLY_BROWSER_EXECUTABLE_PATH" `
  -- uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server `
  kindly-web-search-mcp-server start-mcp-server

Windows (PowerShell, Tavily):``powershell codex mcp add kindly-web-search
--env TAVILY_API_KEY="$env:TAVILY_API_KEY" --env GITHUB_TOKEN="$env:GITHUB_TOKEN"
--env KINDLY_BROWSER_EXECUTABLE_PATH="$env:KINDLY_BROWSER_EXECUTABLE_PATH" -- uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server
kindly-web-search-mcp-server start-mcp-server


Alternative (file-based):
Edit `~/.codex/config.toml`:```toml
[mcp_servers.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",
]
# Forward variables from your shell/OS environment:
env_vars = ["SERPER_API_KEY", "SERPBASE_API_KEY", "TAVILY_API_KEY", "SEARXNG_BASE_URL", "SOFYA_API_KEY", "YDC_API_KEY", "SERPLY_API_KEY", "APIFARE_TOKEN", "GITHUB_TOKEN", "KINDLY_BROWSER_EXECUTABLE_PATH"]
startup_timeout_sec = 120.0

Claude Code

Set one of SERPER_API_KEY, SERPBASE_API_KEY, TAVILY_API_KEY, SEARXNG_BASE_URL, SOFYA_API_KEY, YDC_API_KEY, SERPLY_API_KEY, or APIFARE_TOKEN.

CLI (no file editing) — add a local stdio MCP server:

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


macOS / Linux (Tavily):```bash
claude mcp add --transport stdio kindly-web-search \
  -e TAVILY_API_KEY="$TAVILY_API_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  -e KINDLY_BROWSER_EXECUTABLE_PATH="$KINDLY_BROWSER_EXECUTABLE_PATH" \
  -- uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server \
  kindly-web-search-mcp-server start-mcp-server

If you use SearXNG, replace the provider env var above with:```bash
-e SEARXNG_BASE_URL="$SEARXNG_BASE_URL"


Windows (PowerShell):```powershell
claude mcp add --transport stdio kindly-web-search `
  -e SERPER_API_KEY="$env:SERPER_API_KEY" `
  -e GITHUB_TOKEN="$env:GITHUB_TOKEN" `
  -e KINDLY_BROWSER_EXECUTABLE_PATH="$env:KINDLY_BROWSER_EXECUTABLE_PATH" `
  -- uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server `
  kindly-web-search-mcp-server start-mcp-server

Windows (PowerShell, Tavily):``powershell claude mcp add --transport stdio kindly-web-search
-e TAVILY_API_KEY="$env:TAVILY_API_KEY" -e GITHUB_TOKEN="$env:GITHUB_TOKEN"
-e KINDLY_BROWSER_EXECUTABLE_PATH="$env:KINDLY_BROWSER_EXECUTABLE_PATH" -- uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server
kindly-web-search-mcp-server start-mcp-server


Note: On current Claude Code versions, keep the server name immediately after `--transport stdio` and before `-e/--env` flags. Tested with Claude Code `2.0.76`.

If Claude Code times out while starting the server, set a 120s startup timeout (milliseconds):

macOS / Linux:```bash
export MCP_TIMEOUT=120000

Windows (PowerShell):```powershell
$env:MCP_TIMEOUT="120000"


Alternative (file-based):
Create/edit `.mcp.json` (project scope; recommended for teams):```json
{
  "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": "${SERPER_API_KEY}",
        "TAVILY_API_KEY": "${TAVILY_API_KEY}",
        "SEARXNG_BASE_URL": "${SEARXNG_BASE_URL}",
        "GITHUB_TOKEN": "${GITHUB_TOKEN}",
        "KINDLY_BROWSER_EXECUTABLE_PATH": "${KINDLY_BROWSER_EXECUTABLE_PATH}"
      }
    }
  }
}

Gemini CLI

Set one of SERPER_API_KEY, SERPBASE_API_KEY, TAVILY_API_KEY, SEARXNG_BASE_URL, SOFYA_API_KEY, YDC_API_KEY, SERPLY_API_KEY, or APIFARE_TOKEN.
Edit ~/.gemini/settings.json (or .gemini/settings.json in a project):```json
{
"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": "$SERPER_API_KEY",
"TAVILY_API_KEY": "$TAVILY_API_KEY",
"SEARXNG_BASE_URL": "$SEARXNG_BASE_URL",
"GITHUB_TOKEN": "$GITHUB_TOKEN",
"KINDLY_BROWSER_EXECUTABLE_PATH": "$KINDLY_BROWSER_EXECUTABLE_PATH"
},
"timeout": 120000
}
}
}


### OpenClaw

Set one of `SERPER_API_KEY`, `SERPBASE_API_KEY`, `TAVILY_API_KEY`, `SEARXNG_BASE_URL`, `SOFYA_API_KEY`, `YDC_API_KEY`, `SERPLY_API_KEY`, or `APIFARE_TOKEN`.
If `mcporter` is not installed yet: `npm i -g mcporter`.
mcporter docs:

CLI (no file editing) — `mcporter` (recommended):```bash
# Replace `$...` vars with real values, or export them in your shell first.
mcporter config add kindly-search \
  --scope home \
  --command "uvx --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="$SERPER_API_KEY" \
  --env TAVILY_API_KEY="$TAVILY_API_KEY" \
  --env SEARXNG_BASE_URL="$SEARXNG_BASE_URL" \
  --env GITHUB_TOKEN="$GITHUB_TOKEN" \
  --env KINDLY_BROWSER_EXECUTABLE_PATH="$KINDLY_BROWSER_EXECUTABLE_PATH"

This writes to ~/.mcporter/mcporter.json (--scope home).
You can replace kindly-search with any server name you prefer.
Verify:```bash
mcporter config get kindly-search


Alternative (file-based):
Edit mcporter config (`~/.mcporter/mcporter.json`, or `config/mcporter.json` if you use project scope) and add this under `mcpServers`:```json
{
  "mcpServers": {
    "kindly-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": "PASTE_SERPER_KEY_OR_LEAVE_EMPTY",
        "TAVILY_API_KEY": "PASTE_TAVILY_KEY_OR_LEAVE_EMPTY",
        "SEARXNG_BASE_URL": "PASTE_SEARXNG_URL_OR_LEAVE_EMPTY",
        "GITHUB_TOKEN": "PASTE_GITHUB_TOKEN_OR_LEAVE_EMPTY",
        "KINDLY_BROWSER_EXECUTABLE_PATH": "PASTE_IF_NEEDED"
      }
    }
  }
}

Do not add root-level mcpServers to ~/.openclaw/openclaw.json (OpenClaw config uses strict schema validation and unknown keys are rejected).

If OpenClaw is already running and doesn’t pick up the new server, restart/reload the gateway:```bash
openclaw gateway restart


### Antigravity (Google IDE)

Set one of `SERPER_API_KEY`, `SERPBASE_API_KEY`, `TAVILY_API_KEY`, `SEARXNG_BASE_URL`, `SOFYA_API_KEY`, `YDC_API_KEY`, `SERPLY_API_KEY`, or `APIFARE_TOKEN`.

In Antigravity, open the MCP store, then:

1. Click **Manage MCP Servers**
2. Click **View raw config** (this opens `mcp_config.json`)
3. Add the server config under `mcpServers`, save, then go back and click **Refresh**

Paste this into your `mcpServers` object (don’t overwrite other servers):```json
{
  "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": "PASTE_SERPER_KEY_OR_LEAVE_EMPTY",
      "TAVILY_API_KEY": "PASTE_TAVILY_KEY_OR_LEAVE_EMPTY",
      "SEARXNG_BASE_URL": "PASTE_SEARXNG_URL_OR_LEAVE_EMPTY",
      "GITHUB_TOKEN": "PASTE_GITHUB_TOKEN_OR_LEAVE_EMPTY",
      "KINDLY_BROWSER_EXECUTABLE_PATH": "PASTE_IF_NEEDED"
    }
  }
}

If Antigravity can’t find uvx, replace "uvx" with the absolute path (which uvx on macOS/Linux, where uvx on Windows).
Make sure at least one of SERPER_API_KEY / SERPBASE_API_KEY / TAVILY_API_KEY / SEARXNG_BASE_URL / SOFYA_API_KEY / YDC_API_KEY / SERPLY_API_KEY / APIFARE_TOKEN is non-empty.
If the first start is slow, run the uvx command from Quickstart once in a terminal to prebuild the environment, then click Refresh.
Don’t commit/share mcp_config.json if it contains API keys.

Cursor

Set one of SERPER_API_KEY, SERPBASE_API_KEY, TAVILY_API_KEY, SEARXNG_BASE_URL, SOFYA_API_KEY, YDC_API_KEY, SERPLY_API_KEY, or APIFARE_TOKEN.
Startup timeout: Cursor does not currently expose a per-server startup timeout setting. If the first run is slow, run the uvx command from Quickstart once in a terminal to prebuild the tool environment, then restart Cursor.
Create .cursor/mcp.json:```json
{
"mcpServers": {
"kindly-web-search": {
"type": "stdio",
"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": "${env:SERPER_API_KEY}",
"TAVILY_API_KEY": "${env:TAVILY_API_KEY}",
"SEARXNG_BASE_URL": "${env:SEARXNG_BASE_URL}",
"GITHUB_TOKEN": "${env:GITHUB_TOKEN}",
"KINDLY_BROWSER_EXECUTABLE_PATH": "${env:KINDLY_BROWSER_EXECUTABLE_PATH}"
}
}
}
}


### Claude Desktop

Edit `claude_desktop_config.json`:

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`

Note: values in this file are literal strings. Don’t commit this file or share it.
Startup timeout: Claude Desktop does not expose a per-server startup timeout setting. If the first run is slow, run the `uvx` command from Quickstart once in a terminal to prebuild the tool environment, then restart Claude Desktop.```json
{
  "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": "PASTE_SERPER_KEY_OR_LEAVE_EMPTY",
        "TAVILY_API_KEY": "PASTE_TAVILY_KEY_OR_LEAVE_EMPTY",
        "SEARXNG_BASE_URL": "PASTE_SEARXNG_URL_OR_LEAVE_EMPTY",
        "GITHUB_TOKEN": "PASTE_GITHUB_TOKEN_OR_LEAVE_EMPTY",
        "KINDLY_BROWSER_EXECUTABLE_PATH": "PASTE_IF_NEEDED"
      }
    }
  }
}

GitHub Copilot / Microsoft Copilot (VS Code)

Most secure option: uses interactive prompts, so secrets don’t need to be stored in the file.
Startup timeout: VS Code currently does not expose a per-server startup timeout setting for MCP servers. If the first run is slow, run the uvx command from Quickstart once in a terminal to prebuild the tool environment, then restart VS Code.
Create .vscode/mcp.json:```json
{
"servers": {
"kindly-web-search": {
"type": "stdio",
"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": "${input:serper-api-key}",
"TAVILY_API_KEY": "${input:tavily-api-key}",
"SEARXNG_BASE_URL": "${input:searxng-base-url}",
"GITHUB_TOKEN": "${input:github-token}",
"KINDLY_BROWSER_EXECUTABLE_PATH": "${input:browser-path}"
}
}
},
"inputs": [
{ "id": "serper-api-key", "type": "promptString", "description": "Serper API key (optional if using Tavily or SearXNG)" },
{ "id": "tavily-api-key", "type": "promptString", "description": "Tavily API key (optional if using Serper or SearXNG)" },
{ "id": "searxng-base-url", "type": "promptString", "description": "SearXNG base URL (optional if using Serper or Tavily)" },
{ "id": "github-token", "type": "promptString", "description": "GitHub token (recommended)" },
{ "id": "browser-path", "type": "promptString", "description": "Browser binary path (only if needed)" }
]
}


## Browser path (only if auto-detection fails)

Set `KINDLY_BROWSER_EXECUTABLE_PATH` to your browser binary.

macOS (Google Chrome):```bash
export KINDLY_BROWSER_EXECUTABLE_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"

macOS (Homebrew Chromium):```bash
export KINDLY_BROWSER_EXECUTABLE_PATH="/Applications/Chromium.app/Contents/MacOS/Chromium"


Linux:```bash
export KINDLY_BROWSER_EXECUTABLE_PATH="$(command -v chromium || command -v chromium-browser)"

Windows (PowerShell):```powershell
$env:KINDLY_BROWSER_EXECUTABLE_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe"


## Chromium proxy (optional)

Set `KINDLY_CHROME_PROXY` to route all headless Chromium traffic (used for `page_content` extraction) through a proxy server. The value is passed directly as Chromium's `--proxy-server` flag.

Supported schemes: `http://`, `https://`, `socks5://`, `socks4://`.```bash
export KINDLY_CHROME_PROXY="socks5://127.0.0.1:1080"

When running in Docker, use host.docker.internal instead of 127.0.0.1 to reach the host:```bash
docker run ... -e KINDLY_CHROME_PROXY="socks5://host.docker.internal:1080" ...


This only affects Chromium-based `page_content` extraction. Search API calls (Serper, Tavily, SearXNG) use `httpx` and respect standard `HTTP_PROXY` / `HTTPS_PROXY` / `ALL_PROXY` environment variables instead.

Note: Chromium's `--proxy-server` does not support embedded credentials (e.g. `socks5://user:pass@host:port` will not work). If your proxy requires authentication, set up a local credential-less proxy forwarder (e.g. SSH tunnel, `gost`, `socat`) and point `KINDLY_CHROME_PROXY` to the local endpoint.

### Proxy bypass list

Set `KINDLY_CHROME_PROXY_BYPASS` to exclude specific hosts from the proxy. The value is passed directly as Chromium's `--proxy-bypass-list` flag (comma-separated). Syntax:

- Exact host: `localhost`, `127.0.0.1`
- Wildcard suffix: `*.example.com`, `.local`
- IPv6: `[::1]````bash
export KINDLY_CHROME_PROXY_BYPASS="localhost,127.0.0.1,*.internal"

When unset, Chromium uses its default bypass list (which includes localhost and 127.0.0.1).

Remote / Docker deployment (separate machine)

Whether you can run the MCP server on a different PC depends on your MCP client:

  • Stdio / command-based clients (config uses command + args to spawn the server): the server must run on the same machine (or at least somewhere the client can run the command). You can still use Docker, but locally (the client launches docker run ...).
  • HTTP-capable clients (can connect to a server URL): you can run Kindly remotely in Docker using Streamable HTTP.

Prebuilt image (GHCR)

Pull the image instead of building it. It is published for Intel/AMD
(linux/amd64) and ARM (linux/arm64) — so it runs on ordinary servers and PCs,
on an Apple Silicon Mac, and on ARM cloud instances:```bash

Newest build of the default branch:

docker pull ghcr.io/shelpuk-ai-technology-consulting/kindly-web-search-mcp-server:latest

Or one build that never changes, using its digest from the package page:

docker pull ghcr.io/shelpuk-ai-technology-consulting/kindly-web-search-mcp-server@sha256:<digest>
```

> If docker pull says denied or unauthorized, the package is still
> private. GitHub creates a new container package as private even under a public
> repository — a package inherits the repository's permissions but not its
> visibility, and there is no API for it. A maintainer has to open the package's

…(正文过长,页面只展示前面部分,完整内容见仓库)

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
kindly-web-search-mcp-server 怎么安装?

在客户端按下面的安装命令接入:pip install kindly-web-search-mcp-server。对应的包名是 kindly-web-search-mcp-server。装完在客户端配置里引用同一个包或端点。

kindly-web-search-mcp-server 怎么在 Claude Desktop、Cursor、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

kindly-web-search-mcp-server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

kindly-web-search-mcp-server 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

kindly-web-search-mcp-server 支持哪些客户端?

资料标注支持 Claude Desktop、Cursor、Cline、Claude Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

kindly-web-search-mcp-server 能提供哪些能力?

资料显示能力标签包括 kindly-web-search-mcp-server、ai、ai-agents、ai-tools、claude-code。具体工具清单以官方文档为准。

kindly-web-search-mcp-server 需要什么运行环境?

运行时为 Cross-platform;属于本地进程,需要在本机装好运行环境。

kindly-web-search-mcp-server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-04-11。