mcp server

Local 2025-08-31 23:08:36 0
Browser Automation @divslingerx/mcp-server

A lightweight, stateless MCP server utilizing Puppeteer for web searches, returning structured JSON results, easily integratable with other MCP-enabled systems.

A Model Context Protocol (MCP) server that provides web search capabilities using Puppeteer.

Features

  • Web search functionality via Google
  • Structured JSON results
  • Lightweight and stateless design
  • Easy integration with MCP-enabled systems

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/mcp-server.git
cd mcp-server
  1. Install dependencies:
npm install
  1. Build the project: 
    npm run build

Configuration

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

Usage

Start the server:

npm start

The server will be available to MCP clients. Example usage through MCP:

{
  "tool": "search_web",
  "arguments": {
    "query": "example search"
  }
}

Development

Building the Project

npm run build

Running Tests

npm test

Linting

npm run lint

Formatting

npm run format

License

This project is licensed under the MIT License - see the LICENSE file for details.

[
  {
    "description": "Search the web using Google",
    "inputSchema": {
      "properties": {
        "query": {
          "description": "Search query",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "name": "search_web"
  }
]