Saaros-MCP-Server
@mjochum64
A Model Context Protocol (MCP) server that provides access to the Brave Search API, running as a background thread
Overview
What is Saaros-MCP-Server?
Saaros-MCP-Server is a Model Context Protocol (MCP) server that provides access to the Brave Search API, running as a background thread. It is implemented in Python and communicates via stdin/stdout using JSON-RPC 2.0.
How to use Saaros-MCP-Server?
Create a .env file with your Brave Search API key, then run uv run main.py. The server listens for JSON-RPC 2.0 requests on stdin, such as listTools and callTool with the brave_web_search tool. Example arguments include query (string) and count (integer).
Key features of Saaros-MCP-Server
- Runs as a background thread
- Implements JSON-RPC 2.0 protocol
- Rate limiting support
- Brave Search API integration
Use cases of Saaros-MCP-Server
- Perform web searches via the Brave Search API from an MCP client
- Integrate search capabilities into larger Python applications
- Query web results with configurable result count
FAQ from Saaros-MCP-Server
What API does Saaros-MCP-Server integrate with?
It integrates with the Brave Search API.
How do I set up the API key?
Place your Brave Search API key in a .env file as BRAVE_API_KEY=your_api_key_here.
How do I run Saaros-MCP-Server?
Execute uv run main.py from the project root.
What protocol does the server use for communication?
It uses the JSON-RPC 2.0 protocol over stdin/stdout.
What tools are available?
The server exposes a brave_web_search tool that accepts query and count arguments.
