Skip to main content
Glama
hightemp

go_serper_mcp_server

by hightemp
OverviewSchemaRelated ServersScoreDiscussions
Go
Remote

go_serper_mcp_server

A Go implementation of an MCP server that exposes the full Serper Google Search API surface, plus Serper's webpage scrape endpoint.

Requirements

  • Go 1.23+

  • A Serper API key (SERPER_API_KEY)

Related MCP server: @missionsquad/mcp-searxng-puppeteer

Available Tools

  • google_search

  • google_search_images

  • google_search_videos

  • google_search_places

  • google_search_maps

  • google_search_reviews

  • google_search_news

  • google_search_shopping

  • google_search_lens

  • google_search_scholar

  • google_search_patents

  • google_search_autocomplete

  • webpage_scrape

Configuration

Set your Serper API key as an environment variable:

export SERPER_API_KEY="your-key"

Optional:

  • AIOHTTP_TIMEOUT (seconds, default: 15) - matches the reference server's timeout env name.

Running

Stdio (default for most MCP clients)

go run . -t stdio

SSE

go run . -t sse -p 8894

SSE endpoint:

http://localhost:8894/sse

Build

make build

Binary output: ./go_serper_mcp_server

npm / npx

This repo includes an npm wrapper so the server can be installed and run via npx.

Build npm package (multi-platform binaries)

npm run build:npm

This creates platform binaries under native/ and prepares the package for npm pack/publish.

Run with npx

After publishing the package (or using a local tarball), you can run:

SERPER_API_KEY=your-key npx go-serper-mcp-server -t stdio

To run a specific version:

SERPER_API_KEY=your-key npx go-serper-mcp-server@1.0.0 -t stdio

For a local tarball:

npm pack
SERPER_API_KEY=your-key npx ./go-serper-mcp-server-*.tgz -t stdio

Claude Code

claude mcp add --transport stdio serper -- npx -y go-serper-mcp-server -t stdio
claude mcp add serper --transport stdio --env SERPER_API_KEY=YOUR_KEY -- npx -y go-serper-mcp-server -t stdio
claude mcp add serper --transport stdio --scope user --env SERPER_API_KEY=YOUR_KEY -- npx -y go-serper-mcp-server -t stdio

In project .mcp.json or global ~/.claude.json

{
  "mcpServers": {
    "serper": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "go-serper-mcp-server", "-t", "stdio"],
      "env": {
        "SERPER_API_KEY": "${SERPER_API_KEY}"
      }
    }
  }
}

Codex CLI

Codex supports MCP servers in ~/.codex/config.toml or via the codex mcp add command.

Add via CLI:

codex mcp add serper -- npx -y go-serper-mcp-server -t stdio

Or configure in ~/.codex/config.toml:

[mcp_servers.serper]
command = "npx"
args = ["-y", "go-serper-mcp-server", "-t", "stdio"]
env = { "SERPER_API_KEY" = "${SERPER_API_KEY}" }

Cursor

  • macOS/Linux: ~/.cursor/mcp.json

  • Windows: %USERPROFILE%\\.cursor\\mcp.json

{
  "mcpServers": {
    "serper": {
      "command": "npx",
      "args": ["-y", "go-serper-mcp-server", "-t", "stdio"],
      "env": {
        "SERPER_API_KEY": "PASTE_YOUR_KEY_HERE"
      }
    }
  }
}

MCP Client Config Example

{
  "mcpServers": {
    "serper": {
      "command": "/path/to/go_serper_mcp_server",
      "args": ["-t", "stdio"],
      "env": {
        "SERPER_API_KEY": "your-key"
      }
    }
  }
}

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • evo-scry

    krich11
    A
    license
    -
    quality
    D
    maintenance
    MCP server for internet search via direct Google and DuckDuckGo HTML scraping with AI-powered result normalization and optional summarization, requiring no API keys for search.
    MIT

  • SearchMCP

    MachineLearning-Nerd
    A
    license
    A
    quality
    D
    maintenance
    A privacy-focused web search and content extraction MCP server. It integrates SearxNG with fallback to Google scraping, featuring relevance ranking, security-aware search, and rate limiting.
    3
    MIT

View all related MCP servers

Related MCP Connectors

  • Serper

    Serper MCP — wraps the Serper Google Search API (serper.dev)

  • mcp-serp

    MCP server for Google search results via SERP API

  • Serpapi

    SerpApi MCP — wraps SerpApi (serpapi.com) search engines

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hightemp/go_serper_mcp_server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server