================== /// MCP /// /// G-S /// ================== [server:online] [protocol:ready]
g-search-mcp
by jae-jae
MCP server for Google search using Playwright that supports parallel, multi-keyword searching and returns structured JSON results.
186
14
Open Source01
search
Execute Google searches with multiple keywords and return results
Installation
1. Clone the repository
git clone https://github.com/jae-jae/g-search-mcp.git
cd g-search-mcp
2. Install dependencies
# with npm
npm install
# or with pnpm / yarn
pnpm install
3. Build the TypeScript sources (if the project is pre-compiled you can skip)
npm run build # usually runs tsc
4. Configuration
• Copy the example env file (if present)
• Adjust the following variables in .env or config.json
• Make sure the host has the required Playwright browser binaries. If not, run:
cp .env.example .env
MCP_PORT – Port the server will listen on (default 3000)
MCP_HOST – Bind address (default 0.0.0.0)
CONCURRENCY – Number of browser contexts Playwright can launch
PROXY_URL – (optional) proxy string for Google scraping
npx playwright install
5. Start the MCP server
# for development with hot-reload
npm run dev
# production
NODE_ENV=production npm start
6. Verify
Open http://localhost:3000/health ‑ should return { status: "ok" }
Documentation
License: MIT License
Updated 7/30/2025