http-mcp-web-search-server
If you are the rightful owner of http-mcp-web-search-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
An MCP (Model Context Protocol) server that provides web search functionality using the Brave Search API.
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)
- Parameters:
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.
