mcp-sse-client-server
3.2
If you are the rightful owner of mcp-sse-client-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.
A Simple Python implementation of a MCP client and Server with Server-Sent Events (SSE).
MCP SSE Client-Server
A Simple Python implementation of a MCP client and Server with Server-Sent Events (SSE).
Features
- SSE-based communication between client and server
- Integration with MCP platform tools (google_search, get_web_content)
- Asynchronous processing of queries using Python's asyncio
- Comprehensive logging and error handling
- OpenAI API integration with fallback to OpenRouter
- Environment variable configuration support
Requirements
- Python 3.10+
- Dependencies listed in pyproject.toml:
- httpx for HTTP requests
- python-dotenv for environment variables
- openai for LLM integration
- mcp[cli] for MCP platform integration
Installation
- Clone this repository
- Create and activate a virtual environment:
uv venv # On Windows .venv\Scripts\activate # On Unix/macOS source .venv/bin/activate - Install dependencies:
uv sync .
Configuration
Create a .env file in the project root with your API keys:
# Required - use either OPENAI_API_KEY or OPENROUTER_API_KEY
OPENAI_API_KEY=your_api_key
OPENROUTER_API_KEY=your_api_key
# Optional - specify custom base URL
OPENAI_BASE_URL=https://your-custom-url
OPENROUTER_BASE_URL=https://your-custom-url
Usage
start mcp server firstly, which run on 8081 port. then start mcp client.
MCP Server Setup
uv run mcp-server-search.py
MCP Client Usage
uv run mcp-client-sse.py --help
usage: mcp-client-sse.py [-h] [--server SERVER] [--verbose] [--quiet]
Run MCP SSE-based client
options:
-h, --help show this help message and exit
--server SERVER MCP SSE server URL (default: http://localhost:8081/sse)
--verbose Enable verbose logging mode (DEBUG level)
--quiet Set logging to WARNING level (overrides --verbose)
uv run mcp-client-sse.py --server URL_ADDRESS-server-url:8081/sse --verbose
Available MCP Tools
The client supports these MCP tools:
- google_search: Perform web searches
- get_web_content: Fetch full web page content
- get_weekday_from_date: Date utilities
- get_weather_for_date: Weather information
Development
Logging
The client generates logs in mcp-client.log with timestamps and detailed information.
Testing
To be implemented...
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss proposed changes.
