serper-search-mcp 2.0.0 → 2.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -13
- package/dist/index.js +1 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
# Serper Search MCP Server v2.0.
|
|
1
|
+
# Serper Search MCP Server v2.0.1 - Enterprise Edition
|
|
2
2
|
|
|
3
3
|
🚀 **Enterprise-grade Google search MCP server** with **dual architecture**: JavaScript for integration + TypeScript for enterprise development.
|
|
4
4
|
|
|
5
5
|
👨💻 **Author:** SMJAHID from SMLabs01
|
|
6
|
-
📦 **NPM:**
|
|
7
|
-
🐳 **Docker:** `
|
|
6
|
+
📦 **NPM:** [`serper-search-mcp`](https://www.npmjs.com/package/serper-search-mcp)
|
|
7
|
+
🐳 **Docker:** [`smjahid/server-serper-search`](https://hub.docker.com/r/smjahid/server-serper-search)
|
|
8
8
|
🔧 **Architecture:** JavaScript (primary) + TypeScript (enterprise modular design)
|
|
9
9
|
|
|
10
10
|
---
|
|
@@ -48,7 +48,7 @@ src/
|
|
|
48
48
|
- 🚀 **Multi-Transport**: STDIO (default) and HTTP/SSE transport modes
|
|
49
49
|
- 🌍 **Advanced Filtering**: Country, language, freshness, and content filters
|
|
50
50
|
- 🤖 **AI Summarization**: Generate summaries from search results
|
|
51
|
-
- 🐳 **Docker Support**: Multi-stage builds with
|
|
51
|
+
- 🐳 **Docker Support**: Multi-stage builds with smjahid namespace
|
|
52
52
|
- 📦 **NPM Package**: TypeScript with full CLI support
|
|
53
53
|
- ⚡ **Fast Results**: Optimized API client with error handling
|
|
54
54
|
- 🎯 **Structured Data**: Clean JSON responses perfect for AI processing
|
|
@@ -66,7 +66,7 @@ node index.js --help
|
|
|
66
66
|
SERPER_MCP_TRANSPORT=http SERPER_MCP_PORT=8080 node index.js
|
|
67
67
|
|
|
68
68
|
# Docker integration
|
|
69
|
-
docker run -e SERPER_API_KEY=your_key
|
|
69
|
+
docker run -e SERPER_API_KEY=your_key smjahid/server-serper-search:2.0.0
|
|
70
70
|
```
|
|
71
71
|
|
|
72
72
|
**Why JavaScript for Integration:**
|
|
@@ -120,12 +120,12 @@ node dist/index.js --help
|
|
|
120
120
|
|
|
121
121
|
1. **Pull from Docker Hub** (Recommended):
|
|
122
122
|
```bash
|
|
123
|
-
docker pull
|
|
123
|
+
docker pull smjahid/server-serper-search:2.0.0
|
|
124
124
|
```
|
|
125
125
|
|
|
126
126
|
2. **Or build locally**:
|
|
127
127
|
```bash
|
|
128
|
-
docker build -t
|
|
128
|
+
docker build -t smjahid/server-serper-search:2.0.0 .
|
|
129
129
|
```
|
|
130
130
|
|
|
131
131
|
3. **Configure the MCP server**:
|
|
@@ -140,7 +140,7 @@ docker build -t smlabs01/server-serper-search:2.0.0 .
|
|
|
140
140
|
"--rm",
|
|
141
141
|
"-e",
|
|
142
142
|
"SERPER_API_KEY=your_actual_api_key_here",
|
|
143
|
-
"
|
|
143
|
+
"smjahid/server-serper-search:2.0.0"
|
|
144
144
|
]
|
|
145
145
|
}
|
|
146
146
|
}
|
|
@@ -332,7 +332,7 @@ The server supports all major Google search types through the Serper API:
|
|
|
332
332
|
|
|
333
333
|
## Usage Scenarios
|
|
334
334
|
|
|
335
|
-
With these comprehensive search capabilities,
|
|
335
|
+
With these comprehensive search capabilities, Serper MCP server can be used for:
|
|
336
336
|
|
|
337
337
|
### 🤖 **AI & Machine Learning**
|
|
338
338
|
- **Dataset Collection**: Gather images for training computer vision models
|
|
@@ -396,8 +396,6 @@ For issues and questions:
|
|
|
396
396
|
```
|
|
397
397
|
JavaScript (Primary): index.js - Single file deployment
|
|
398
398
|
TypeScript (Enterprise): src/ (6 modules) - Modular architecture
|
|
399
|
-
Docker: smlabs01/server-serper-search:2.0.0
|
|
400
|
-
NPM: @modelcontextprotocol/server-serper-search
|
|
401
399
|
```
|
|
402
400
|
|
|
403
401
|
**⬆️ Migration from v1.x:**
|
|
@@ -422,7 +420,7 @@ NPM: @modelcontextprotocol/server-serper-search
|
|
|
422
420
|
| **Primary Server** | ✅ `index.js` | ❌ `src/` (enterprise) | ✅ **JavaScript** |
|
|
423
421
|
| **Transport Support** | ✅ HTTP/SSE + STDIO | ✅ STDIO | ✅ **JavaScript** |
|
|
424
422
|
| **Build Required** | ❌ No | ✅ Yes (`npm run build`) | ✅ **JavaScript** |
|
|
425
|
-
| **Docker Hub** | ✅ `
|
|
423
|
+
| **Docker Hub** | ✅ `smjahid/server-serper-search` | ✅ Same | ✅ **Both** |
|
|
426
424
|
| **Enterprise Ready** | ❌ Simple | ✅ Modular structure | ✅ **TypeScript** |
|
|
427
425
|
|
|
428
|
-
---
|
|
426
|
+
---
|
package/dist/index.js
CHANGED
|
@@ -68,7 +68,7 @@ Examples:
|
|
|
68
68
|
node dist/index.js --transport http --port 3000
|
|
69
69
|
|
|
70
70
|
# Docker deployment
|
|
71
|
-
docker run -e SERPER_API_KEY=your_key
|
|
71
|
+
docker run -e SERPER_API_KEY=your_key smjahid/server-serper-search
|
|
72
72
|
|
|
73
73
|
Author: SMJAHID from SMLabs01
|
|
74
74
|
`);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "serper-search-mcp",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.2",
|
|
4
4
|
"description": "MCP server for Serper API (Google search results) with multi-transport support",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"bin": {
|
|
@@ -12,8 +12,8 @@
|
|
|
12
12
|
"dev": "SERPER_API_KEY=test npm run build && node dist/index.js",
|
|
13
13
|
"http": "SERPER_MCP_TRANSPORT=http npm run build && node dist/index.js",
|
|
14
14
|
"stdio": "SERPER_MCP_TRANSPORT=stdio npm run build && node dist/index.js",
|
|
15
|
-
"docker:build": "docker build -t
|
|
16
|
-
"docker:run": "docker run -i --rm -e SERPER_API_KEY
|
|
15
|
+
"docker:build": "docker build -t smjahid/server-serper-search .",
|
|
16
|
+
"docker:run": "docker run -i --rm -e SERPER_API_KEY smjahid/server-serper-search",
|
|
17
17
|
"compose:up": "docker-compose up",
|
|
18
18
|
"compose:dev": "docker-compose --profile dev up",
|
|
19
19
|
"help": "node dist/index.js --help",
|