A Model Context Protocol (MCP) server that provides web search capabilities using Puppeteer.
- Web search functionality via Google
- Structured JSON results
- Lightweight and stateless design
- Easy integration with MCP-enabled systems
-
Clone the repository:
git clone https://github.com/yourusername/mcp-server.git cd mcp-server
-
Install dependencies:
npm install
-
Build the project:
npm run build
Create a .env
file in the project root with the following environment variables:
# Puppeteer configuration
PUPPETEER_EXECUTABLE_PATH=/path/to/chrome
PUPPETEER_HEADLESS=true
# Server settings
PORT=3000
Start the server:
npm start
The server will be available to MCP clients. Example usage through MCP:
{
"tool": "search_web",
"arguments": {
"query": "example search"
}
}
npm run build
npm test
npm run lint
npm run format
This project is licensed under the MIT License - see the LICENSE file for details.