Exposes the Serper Google Search API to perform comprehensive searches across Google Search, Images, Videos, Places, Maps, News, Shopping, Scholar, and Patents, as well as providing webpage scraping capabilities.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@go_serper_mcp_serverfind the latest news about generative AI developments"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_searchgoogle_search_imagesgoogle_search_videosgoogle_search_placesgoogle_search_mapsgoogle_search_reviewsgoogle_search_newsgoogle_search_shoppinggoogle_search_lensgoogle_search_scholargoogle_search_patentsgoogle_search_autocompletewebpage_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 stdioSSE
go run . -t sse -p 8894SSE endpoint:
http://localhost:8894/sseBuild
make buildBinary 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:npmThis 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 stdioTo run a specific version:
SERPER_API_KEY=your-key npx go-serper-mcp-server@1.0.0 -t stdioFor a local tarball:
npm pack
SERPER_API_KEY=your-key npx ./go-serper-mcp-server-*.tgz -t stdioClaude Code
claude mcp add --transport stdio serper -- npx -y go-serper-mcp-server -t stdioclaude mcp add serper --transport stdio --env SERPER_API_KEY=YOUR_KEY -- npx -y go-serper-mcp-server -t stdioclaude mcp add serper --transport stdio --scope user --env SERPER_API_KEY=YOUR_KEY -- npx -y go-serper-mcp-server -t stdioIn 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 stdioOr 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.jsonWindows:
%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
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.