Advertise
MCP.so
Sign In

MCP Client Example

@RGGH

RepositoryHomepage

Basic information

Category

Other

Transports

stdio

Author

RGGH

About MCP Client Example

Python MCP client + server example

MCP Client Example 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"
      ]
    }
  }
}

MCP Client Example tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

What is MCP?

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

2

What are the prerequisites to run the example?

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

3

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.

4

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).

5

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

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K
Advertise