Skip to content
Back to search

mcp-server-serper

Serper MCP Server supporting search and webpage scraping

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/marcopesani--mcp-server-serper/badge.svg)](/listings/marcopesani--mcp-server-serper)

HTML

<a href="/listings/marcopesani--mcp-server-serper"><img src="/api/listings/marcopesani--mcp-server-serper/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installing via Smithery

To install Serper Search and Scrape for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@marcopesani/mcp-server-serper):

npx -y @smithery/cli install @marcopesani/mcp-server-serper --client claude

Claude Desktop

Add the server config at: - MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "serper-search": {
      "command": "npx",
      "args": ["-y", "serper-search-scrape-mcp-server"],
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cline

1. Open the Cline extension settings 2. Open "MCP Servers" tab 3. Click on "Configure MCP Servers" 4. Add the server config:

{
  "mcpServers": {
    "github.com/marcopesani/mcp-server-serper": {
      "command": "npx",
      "args": ["-y", "serper-search-scrape-mcp-server"],
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": ["google_search", "scrape"]
    }
  }
}

Additional Cline configuration options: - `disabled`: Set to `false` to enable the server - `autoApprove`: List of tools that don't require explicit approval for each use

Cursor

1. Open the Cursor settings 2. Open "Features" settings 3. In the "MCP Servers" section, click on "Add new MCP Server" 4. Choose a name, and select "command" as "Type" 5. In the "Command" field, enter the following:

env SERPER_API_KEY=your_api_key_here npx -y serper-search-scrape-mcp-server

Docker

You can also run the server using Docker. First, build the image:

docker build -t mcp-server-serper .

Then run the container with your Serper API key:

docker run -e SERPER_API_KEY=your_api_key_here mcp-server-serper

Alternatively, if you have your environment variables in a `.env` file:

docker run --env-file .env mcp-server-serper

For development, you might want to mount your source code as a volume:

docker run -v $(pwd):/app --env-file .env mcp-server-serper

Note: Make sure to replace `your_api_key_here` with your actual Serper API key.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 179 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Serper Search and Scrape MCP Server
  2. [![smithery badge](https://smithery.ai/badge/@marcopesani/mcp-server-serper)](https://smithery.ai/server/@marcopesani/mcp-server-serper)
  3. A TypeScript-based MCP server that provides web search and webpage scraping capabilities using the Serper API. This server integrates with Claude Desktop to enable powerful web search and content extraction features.
  4. <a href="https://glama.ai/mcp/servers/5zk327i0pj">
  5. <img width="380" height="200" src="https://glama.ai/mcp/servers/5zk327i0pj/badge" alt="serper-search-scrape-mcp-server MCP server" />
  6. </a>
  7. ## Features
  8. ### Tools
  9. - `google_search` - Perform web searches via Serper API
  10. - Rich search results including organic results, knowledge graph, "people also ask", and related searches
  11. - Supports region and language targeting
  12. - Optional parameters for location, pagination, time filters, and autocorrection
  13. - Supports advanced search operators:
  14. - `site`: Limit results to specific domain
  15. - `filetype`: Limit to specific file types (e.g., 'pdf', 'doc')
  16. - `inurl`: Search for pages with word in URL
  17. - `intitle`: Search for pages with word in title
  18. - `related`: Find similar websites
  19. - `cache`: View Google's cached version of a specific URL
  20. - `before`: Date before in YYYY-MM-DD format
  21. - `after`: Date after in YYYY-MM-DD format
  22. - `exact`: Exact phrase match
  23. - `exclude`: Terms to exclude from search results
  24. - `or`: Alternative terms (OR operator)
  25. - `scrape` - Extract content from web pages
  26. - Get plain text and optional markdown content
  27. - Includes JSON-LD and head metadata
  28. - Preserves document structure
  29. ## Requirements
  30. - Node.js >= 18
  31. - Serper API key (set as `SERPER_API_KEY` environment variable)
  32. ## Development
  33. Install dependencies:
  34. ```bash
  35. npm install
  36. ```
  37. Build the server:
  38. ```bash
  39. npm run build
  40. ```
  41. For development with auto-rebuild:
  42. ```bash
  43. npm run watch
  44. ```
  45. Run tests:
  46. ```bash
  47. npm test # Run all tests
  48. npm run test:watch # Run tests in watch mode
  49. npm run test:coverage # Run tests with coverage
  50. npm run test:integration # Run integration tests
  51. ```
  52. ### Environment Variables
  53. Create a `.env` file in the root directory:
  54. ```
  55. SERPER_API_KEY=your_api_key_here
  56. ```
  57. ### Debugging
  58. Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script:
  59. ```bash
  60. npm run inspector
  61. ```
  62. The Inspector will provide a URL to access debugging tools in your browser.
  63. ## Installation
  64. ### Installing via Smithery
  65. To install Serper Search and Scrape for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@marcopesani/mcp-server-serper):
  66. ```bash
  67. npx -y @smithery/cli install @marcopesani/mcp-server-serper --client claude
  68. ```
  69. ### Claude Desktop
  70. Add the server config at:
  71. - MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
  72. - Windows: `%APPDATA%/Claude/claude_desktop_config.json`
  73. ```json
  74. {
  75. "mcpServers": {
  76. "serper-search": {
  77. "command": "npx",
  78. "args": ["-y", "serper-search-scrape-mcp-server"],
  79. "env": {
  80. "SERPER_API_KEY": "your_api_key_here"
  81. }
  82. }
  83. }
  84. }
  85. ```
  86. ### Cline
  87. 1. Open the Cline extension settings
  88. 2. Open "MCP Servers" tab
  89. 3. Click on "Configure MCP Servers"
  90. 4. Add the server config:
  91. ```json
  92. {
  93. "mcpServers": {
  94. "github.com/marcopesani/mcp-server-serper": {
  95. "command": "npx",
  96. "args": ["-y", "serper-search-scrape-mcp-server"],
  97. "env": {
  98. "SERPER_API_KEY": "your_api_key_here"
  99. },
  100. "disabled": false,
  101. "autoApprove": ["google_search", "scrape"]
  102. }
  103. }
  104. }
  105. ```
  106. Additional Cline configuration options:
  107. - `disabled`: Set to `false` to enable the server
  108. - `autoApprove`: List of tools that don't require explicit approval for each use
  109. ### Cursor
  110. 1. Open the Cursor settings
  111. 2. Open "Features" settings
  112. 3. In the "MCP Servers" section, click on "Add new MCP Server"
  113. 4. Choose a name, and select "command" as "Type"
  114. 5. In the "Command" field, enter the following:
  115. ```
  116. env SERPER_API_KEY=your_api_key_here npx -y serper-search-scrape-mcp-server
  117. ```
  118. ### Docker
  119. You can also run the server using Docker. First, build the image:
  120. ```bash
  121. docker build -t mcp-server-serper .
  122. ```
  123. Then run the container with your Serper API key:
  124. ```bash
  125. docker run -e SERPER_API_KEY=your_api_key_here mcp-server-serper
  126. ```
  127. Alternatively, if you have your environment variables in a `.env` file:
  128. ```bash
  129. docker run --env-file .env mcp-server-serper
  130. ```
  131. For development, you might want to mount your source code as a volume:
  132. ```bash
  133. docker run -v $(pwd):/app --env-file .env mcp-server-serper
  134. ```
  135. Note: Make sure to replace `your_api_key_here` with your actual Serper API key.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.