Saaros-MCP-Server
About
A Model Context Protocol (MCP) server that provides access to the Brave Search API, running as a background thread
Details
- Author
- mjochum64
- Downloads
- 182
- Categories
- Search
Jump to
- Runs as a background thread
- Implements JSON-RPC 2.0 protocol
- Rate limiting support
- Brave Search API integration
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Saaros-MCP-ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"saaros-mcp-server": {
"saaros-mcp-server": {
"command": "uv",
"args": [
"run",
"main.py"
]
}
}
}
}McpServers
{
"saaros-mcp-server": {
"command": "uv",
"args": [
"run",
"main.py"
]
}
}Saaros-MCP-Server
A Model Context Protocol (MCP) server that provides access to the Brave Search API, running as a background thread.
Features
- Runs as a background thread
- Implements JSON-RPC 2.0 protocol
- Rate limiting support
- Brave Search API integration
Setup
1. Set up your Brave Search API key:
- Get an API key from Brave Search API
- Create a .env file in the project root:
BRAVE_API_KEY=your_api_key_here
Usage
The server communicates via stdin/stdout using the JSON-RPC 2.0 protocol. Here are example requests:
1. List available tools:
{
"jsonrpc": "2.0",
"id": 1,
"method": "listTools",
"params": {}
}
2. Perform a web search:
{
"jsonrpc": "2.0",
"id": 2,
"method": "callTool",
"params": {
"name": "brave_web_search",
"arguments": {
"query": "your search query",
"count": 10
}
}
}
To run the server:
uv run main.py
Development
The server is implemented as a Python thread, making it suitable for integration into larger applications. The main components are:
- MCPServer: The main server class that runs in a background thread
- BraveSearchConfig: Configuration class for API settings
- Request/response queues for thread-safe communication
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
