One Search MCP

A Model Context Protocol (MCP) server implementation that integrates with multiple search providers for web search, local browser search, URL discovery, and scraping capabilities with agent-browser.

People connecting browser automation tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-31 · ★ 138 · #33 OF 196 MAINTAINED BROWSER AUTOMATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install One Search MCP

before you install - you'll need

SEARCH_PROVIDER, ALLOW_PRIVATE_NETWORK, SEARCH_API_URL, SEARCH_API_KEY are optional or environment-specific per the README.

Claude Code

claude mcp add yokingma-one-search-mcp -- npx -y one-search-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "yokingma-one-search-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "one-search-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package one-search-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.yokingma is GitHub-verified and matches the repo owner

03 · What One Search MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v1.2.4 · 2026-07-31

add optional you.com search provider · DuckDuckGo safe-search mapping (0=off, 1=moderate, 2=strict). Fixes #11. · Improved one_scrape actions, timeout, TLS override, and full-page screenshots. · New Contributors…

v1.2.2 · 2026-06-26

one-search-mcp v1.2.2 · This release focuses on security hardening and MCP runtime updates. · Hardened browser-backed scraping against SSRF. · Blocked private, loopback, link-local, and other non-public network targets…

v1.2.1 · 2026-04-16

repair searxng provider requests

04 · Who maintains One Search MCP

one-search-mcp is maintained by yokingma. We track 2 MCP servers from yokingma - 2 actively maintained, 209 combined GitHub stars, oldest repo from Mar 2025. Full record: all servers from yokingma.

time-mcp Time MCP Server, giving LLMs time awareness capabilities. ★ 71

05 · Facts

repository: github.com/yokingma/one-search-mcp
category: browser automation - ranked #33 of 196 actively-maintained browser automation servers as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-07-31)
registry: io.github.yokingma/one-search-mcp (active, first published 2026-01-31 · 6 versions)
packages: npm:one-search-mcp

06 · One Search MCP FAQ

What is One Search MCP?

A Model Context Protocol (MCP) server implementation that integrates with multiple search providers for web search, local browser search, URL discovery, and scraping capabilities with agent-browser.

Is One Search MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-31 and it shipped 2 releases in the last 90 days. We re-verify nightly.

How do I install One Search MCP?

Run `npx -y one-search-mcp`. The README documents 4 environment variables (SEARCH_PROVIDER, ALLOW_PRIVATE_NETWORK, SEARCH_API_URL…) to set first. SEARCH_PROVIDER, ALLOW_PRIVATE_NETWORK, SEARCH_API_URL, SEARCH_API_KEY are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does One Search MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to One Search MCP

Alternatives to One Search MCP

Maintained browser automation servers if One Search MCP isn't the fit.

Pairs well with

Servers that cover what One Search MCP doesn't - only shown when the pairing reason fits the companion.

More browser automation MCP servers · UI Ticket MCP · Sniff · Safari MCP · Mac Control MCP · Aethyn Browser MCP

More TypeScript MCP servers · OrchestKit Docs MCP · You.com Web Access & AI · Koncept MCP Server · Opn MCP · Yuque MCP · see all