Multiple MCP SSE Servers with a Python Host
About
This repository contains a python implementation of an MCP Host which is capable of running several MCP Servers with SSE protocol
Details
- Author
- hackerinheels
- GitHub stars
- 1
- Downloads
- 339
- Categories
- Other
Jump to
- Launches and manages multiple MCP servers from a single config file.
- Uses SSE transport for server communication.
- Integrates with Google’s Gemini API for LLM responses.
- Supports calendar management and browser automation servers.
- Handles graceful shutdown and cleanup automatically.
- Can be packaged as a distributable DMG on macOS.
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
Multiple MCP SSE Servers with a Python HostCommand (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
Clone the repository, create a .env file with GEMINI_API_KEY and MODEL_NAME, set up Google Calendar API credentials, update config.json with the MCP server commands, then run uv run host.py from a Python 3.11+ virtual environment. Interact by typing queries in the client prompt.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"multiple mcp sse servers with a python host": {
"multipleMCPServerWithPythonHost": {
"command": "uv",
"args": [
"venv",
"--python",
"3.11"
]
}
}
}
}McpServers
{
"multipleMCPServerWithPythonHost": {
"command": "uv",
"args": [
"venv",
"--python",
"3.11"
]
}
}Multiple MCP SSE Servers with a Python Host
This repository contains a Server-Sent Events (SSE) Model Control Protocol (MCP) client implementation that uses Google's Gemini API. The Host app reads the config.json file, instantiates instances of MCP Client class to launch the MCP servers and maintain connections with them, clean up on shutdown etc.It's possible to package this host app as a dmg package and distribute which can then be used with any MCP SSE ervers.
Todo: Add stdio server support
Todo: Add multiple model support
Todo: Add tool chaining
Setup
1. Clone this repository:
git clone https://github.com/hackerinheels/multipleMCPServerWithPythonHost.git
cd multipleMCPServerWithPythonHost
2. Create a .env file in the root directory with your API keys:
GEMINI_API_KEY=your_api_key_here
MODEL_NAME=gemini-2.0-flash
You can get a Gemini API key from Google's AI Studio.
3. Set up Google Calendar API using the instructions in the googleCalendar/README.md file
4. Update config.json to include the browser-use server:
{
"mcpServers": {
"calendar": {
"command": "uv",
"args": ["run", "googleCalendar/calendarServer.py", "--port", "8000"]
},
"browser-use": {
"command": "uv",
"args": ["run", "<path-to-browser-use-mcp-server>/server", "--port", "8006"]
}
}
}
Replace
<path-to-browser-use-mcp-server> with the actual path where you cloned the repository.5. Create a
.env file in the browser-use-mcp-server directory with the following configuration:CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
Running the Application
uv venv --python 3.11
source .venv/bin/activate
uv pip install -r requirements.txt
uv run host.py
Usage
Once the servers and client are running, you can interact with them by typing queries.
Google Calendar Commands
The calendar server provides the following tools: -list_events: List upcoming calendar events
- get_event_details: Get detailed information about a specific event
- search_events: Search for events matching a query
Example queries:
- "Show my upcoming events"
- "Search for meetings with John"
- "Get details for event {event_id}"
Browser Use For Browser Automation
This tool enable browser automation and control with the following tools: - 'browser_use' - 'browser_get_result'Type quit to exit the client.
Requirements
- Python 3.11+
- UV package manager
- Google Gemini API key
- Google Calendar API credentials (for calendar server)
License
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
