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)

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:

``bash
export SERPER_API_KEY="your-key"
`

Optional:

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

Running

$3

`bash
go run . -t stdio
`

$3

`bash
go run . -t sse -p 8894
`

SSE endpoint:

`
http://127.0.0.1:8894/sse
`

Build

`bash
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.

$3

`bash
npm run build:npm
`

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

$3

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

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

For a local tarball:

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

MCP Client Config Example

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

Notes

- The server mirrors the Serper MCP Python implementation in tmp/serper-mcp-server.
- All requests are sent as JSON to https://google.serper.dev/{endpoint} or https://scrape.serper.dev`.