http-mcp-web-search-server

HTTP-MCP Web Search Server

An MCP (Model Context Protocol) server that provides web search functionality using the Brave Search API.

Setup

# Install dependencies
npm install

# Set your Brave Search API key
export BRAVE_API_KEY=your_api_key

# Start the server
npm start

Features

• Web search using Brave Search API
• HTTP streamable MCP server
• Simple math calculations (from original project)

API Documentation

The server supports the following MCP tool:

• web_search: Performs web searches using the Brave Search API
  • Parameters:
    • query: Search query (required, max 400 chars)
    • count: Number of results (optional, default: 10, max: 20)
    • offset: Pagination offset (optional, default: 0, max: 9)

Using with Docker

Using Environment Variables

# Build the Docker image
docker build -t web-search-server .

# Run with environment variable
docker run -p 3000:3000 -e BRAVE_API_KEY=your_api_key web-search-server

Using .env File

Create a .env file with your API key:

# .env file
BRAVE_API_KEY=your_api_key
PORT=3000

Then run Docker with the env file:

docker run -p 3000:3000 --env-file .env web-search-server

Development

# Run in development mode
npm run dev

# Run tests
npm test

# Format code
npm run format

# Lint code
npm run lint

HTTP-Streamable Time MCP Server

This will start time mcp server as a http-streamable server. You can quickly test the usage of the server by running the src/testClient.ts which is a simple client that uses the time tool.

GitHub Actions

This repository has a GitHub Actions workflow that runs linting, formatting, tests (client-server integration test), and publishes package updates to NPM using semantic-release.