MCP Client Example ☀️

What is MCP Client Example ☀️?

MCP Client Example ☀️ is a demonstration project that implements a simple client-server application using the Model Context Protocol (MCP). It runs on Python 3.9+ and is intended for developers learning how to connect large language models with external tools and data.

How to use MCP Client Example ☀️?

Install Python 3.9+ and uv, then run uv install -e . followed by uv run src/client/mcp_client.py. The client automatically starts the server via stdio, lists available tools, and calls sample tools (BMI calculator and weather fetcher). The project can also be tested with MCP Inspector by running mcp dev src/server/example_server.py and visiting http://localhost:5173.

Key features of MCP Client Example ☀️

• Implements a standard MCP client-server architecture
• Includes two ready-to-use example tools: calculate_bmi and fetch_weather
• Connects to the server via stdio and initializes an MCP session
• Demonstrates both synchronous and asynchronous tool calls
• Provides a tutorial video and MCP Inspector integration
• Licensed under the MIT License

Use cases of MCP Client Example ☀️

• Learning how to build MCP servers and clients from scratch
• Prototyping custom tool integrations for large language models
• Understanding the MCP protocol flow (connect, list tools, call tools)

FAQ from MCP Client Example ☀️

What is the Model Context Protocol?

MCP is a standardized way to connect large language models with tools and data.

What tools are included in the example server?

The server exposes two tools: calculate_bmi (calculates Body Mass Index) and fetch_weather (retrieves weather data from an external API).

What are the prerequisites to run this project?

Python 3.9+ and uv (Python package manager) are required.

How do I run the example client?

Execute uv run src/client/mcp_client.py after installing dependencies with uv install -e ..

What is the license for this project?

The project is licensed under the MIT License.