http-mcp-web-search-server

The HTTP-MCP Web Search Server is a robust Model Context Protocol server designed to facilitate web search functionalities through the Brave Search API. It is built to handle HTTP streamable requests, making it efficient for real-time data retrieval. The server is equipped with features that allow users to perform web searches, execute simple math calculations, and manage HTTP streamable MCP server operations. It is designed to be easily deployable using Docker, with support for environment variables and .env files for configuration. The server also includes a development environment setup with scripts for running in development mode, testing, formatting, and linting code. Additionally, it integrates with GitHub Actions for continuous integration and deployment, ensuring code quality and seamless updates.

Features

• Web search using Brave Search API
• HTTP streamable MCP server
• Simple math calculations

MCP Tools

• web_search: Performs web searches using the Brave Search API with parameters for query, count, and offset.

Usage with Different Platforms

docker_with_env_variables

bash
# 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

docker_with_env_file

bash
# .env file
BRAVE_API_KEY=your_api_key
PORT=3000

# Run Docker with the env file
docker run -p 3000:3000 --env-file .env web-search-server

development

bash
# Run in development mode
npm run dev

# Run tests
npm test

# Format code
npm run format

# Lint code
npm run lint