MCP Client-Server Python Example

This project demonstrates a simple client-server MCP.

---

What is MCP (Model Context Protocol)?

MCP is an open protocol introduced by Anthropic to enable large language models (LLMs) to interact with external tools, APIs, and resources in a standardized, extensible way.

It facilitates secure, multi-channel communication between AI models and external systems, supporting advanced agentic workflows and tool use.

🔗 Anthropic's announcement

🔗 MCP documentation

---

Features

• MCP Server: Exposes tools (e.g., addition) and resources (e.g., greetings) via SSE.
• MCP Client: Connects to the server, lists available tools, and interacts using OpenAI's chat completions.
• OpenAI Integration: Uses OpenAI's GPT models to process user queries and call server tools as needed.

---

Requirements

• Python 3.12+
• MCP Python SDK
• OpenAI Python SDK
• Uvicorn (for running the server)
• python-dotenv (for loading environment variables)
• uv (fast Python package installer and resolver)

Project Structure

.
├── client.py      # MCP client implementation
├── server.py      # MCP server implementation
├── pyproject.toml # Project metadata and dependencies
├── .env           # Environment variables (not committed)
└── README.md      # This file

**Install dependencies with uv:**

uv sync

*(This will install all dependencies as specified in uv.lock.)*

---

Setup

1. Environment Variables

Create a .env file in the project directory:

OPENAI_API_KEY=your-openai-api-key
   MCP_SSE_URL=http://localhost:8080/sse

2. Start the Server

uv run server.py --host 0.0.0.0 --port 8080

The server exposes tools and resources via SSE at /sse.

3. Run the Client

In another terminal:

uv run client.py

The client will connect to the server, list available tools, and start an interactive chat loop.

---

Usage

• Type your queries in the client prompt.
• The client will use OpenAI to process your query and call server tools if needed.
• Type quit to exit the client.