Web Search Sse
web_search is a network search service leveraging the MCP SSE protocol to offer real-time searching capabilities, formatted in Markdown for seamless integration and display. It uses the Tavily API for fetching high-quality web search results and supports Docker for easy deployment.
web_search Project Documentation
Overview
web_search is a network search service using the MCP SSE protocol, allowing users to execute web queries and obtain formatted search results using a simple interface. The service uses the Tavily Search API to deliver high-quality web search results, formatted in Markdown for easy display across platforms.
Features
- Provides a web search tool via MCP protocol
- Utilizes SSE for real-time data streaming
- Automatically registers with the MCP gateway for ecosystem integration
- Returns Markdown-formatted search results with headings, URLs, and summaries
- Supports Docker for containerized deployments
Installation & Deployment
Requirements
- Go 1.24+
- Tavily API Key
Running Directly
Refer to the environment variable configuration for setup instructions.
Docker Deployment
Docker commands provided for image building and container running.
Environment Variable Configuration
| Variable | Default | Description |
|---|---|---|
| TAVILY_SEARCH_API_KEY | None | Tavily search API key, must be set |
| MCP_SERVER_PORT | 8080 | Service listening port |
| MCP_GATEWAY_DOMAIN | http://localhost:3121 | MCP gateway service address |
API Usage
The web_search MCP tool accepts the following parameter:
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Content to search |
Results are organized with a title (H2 format), URL (link format), and a content summary (blockquote format).