MCP HTTP Client Example

by slavashvets

MCP Client 6 stars
  • 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

Documentation

- MCP Specification
- MCP Python SDK