MCP Client Example ☀️

Name: MCP Client Example ☀️
Author: RGGH

@RGGH

Repository Homepage

About MCP Client Example ☀️

Python MCP client + server example

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-client-x": {
      "command": "uv",
      "args": [
        "run",
        "src/client/mcp_client.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Client Example ☀️?

MCP Client Example ☀️ is a demonstrative client-server implementation using the Model Context Protocol (MCP). It shows how to connect a large language model with custom tools and data, intended for developers learning MCP.

How to use MCP Client Example ☀️?

Install dependencies with uv install -e ., then run the client with uv run src/client/mcp_client.py. The client automatically starts the server over stdio, lists available tools, and calls them with sample data.

Key features of MCP Client Example ☀️

Exposes two tools: calculate_bmi and fetch_weather
Client connects to server via stdio transport
Demonstrates synchronous and asynchronous tool calls
Can be tested with the MCP Inspector
Built with Python 3.9+ and the MCP Python SDK

Use cases of MCP Client Example ☀️

Learning how to implement MCP servers and clients
Prototyping custom tools for LLM integration
Testing MCP tool definitions and responses
Building a reference for async tool patterns

FAQ from MCP Client Example ☀️

What is MCP?

Model Context Protocol is a standardized way to connect large language models with tools and data.

What are the prerequisites to run the example?

Python 3.9+ and the uv Python package manager are required.

How do I start the client and server?

Run uv run src/client/mcp_client.py from the project root; the client launches the server automatically.

What tools does the server provide?

The server exposes calculate_bmi (computes Body Mass Index) and fetch_weather (retrieves weather data from an external API).

How can I test the server with MCP Inspector?

Run mcp dev src/server/example_server.py and visit http://localhost:5173 in a browser.

Comments

More Other MCP servers

Core Philosophy: Connect, Unify, Respond

mindsdb

Delegate anything. It comes back done.

39.4K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K