MCP HTTP Client Example
- agent-framework
Simple example client demonstrating how to connect to MCP servers over HTTP (SSE)
About
What is MCP HTTP Client Example?
A simple example client that demonstrates how to connect to MCP (Model Context Protocol) servers over HTTP using Server‑Sent Events (SSE) transport. It is built with the official MCP Python SDK and is intended for developers learning about MCP client‑server communication.
How to use MCP HTTP Client Example?
Clone the repository and run uv run -- main.py <server_url> – for example, uv run -- main.py http://localhost:8000/sse. The client will then connect to the specified MCP server, list its capabilities, and print them as JSON.
Key features of MCP HTTP Client Example
- Connects to MCP servers via SSE transport over HTTP
- Lists available tools, resources, and prompts
- Handles connection lifecycle with async context managers
Use cases of MCP HTTP Client Example
- Learn how to build an MCP client that communicates over HTTP/SSE
- Quickly inspect the capabilities advertised by any MCP server
- Test a local MCP server’s tools, resources, and prompts during development
FAQ from MCP HTTP Client Example
What is the purpose of this client?
It is an example client showing how to connect to MCP servers over HTTP using SSE transport and list their capabilities.
How do I run the client?
Clone the repository, ensure uv is installed, then execute uv run -- main.py <server_url>.
What transport does the client use?
It uses Server‑Sent Events (SSE) over HTTP.
What does the client do after connecting?
It retrieves and prints the server’s available tools, resources, and prompts as JSON.
What are the prerequisites?
The only explicitly required tool is uv. The MCP Python SDK is automatically managed by uv when running the script.
Details
- Author
- slavashvets
- GitHub stars
- 6
- Category
- agent-framework
- Repository
- slavashvets/mcp-http-clilent-example
MCP HTTP Client Example
Simple example client demonstrating how to connect to Model Context Protocol (MCP) servers over HTTP using Server-Sent Events (SSE) transport.
Uses the official MCP Python SDK to handle protocol communication and server interactions.
Features
- Connects to MCP servers over SSE transport
- Lists available tools, resources and prompts
- Properly handles connection lifecycle with async context managers
Requirements
- uv
Usage
Clone this repository, then run the example client:
uv run -- main.py <server_url>
For example:
uv run -- main.py http://localhost:8000/sse
The client will:
1. Connect to the specified MCP server
2. List its available capabilities
3. Print them as JSON
