Introduction To MCP

🚀 MCP Getting Started

A minimal MCP server and client example demonstrating basic calculator operations using SSE (Server-Sent Events) and stdio transports.

🚀 Quick Start

📦 Installation

Install all packages from the requirements.txt file via pip. You can run the following command in the terminal:

pip install -r requirements.txt

🏃‍♂️ Running the Server

Ensure that the mcp package is installed. You can achieve this by running the following command:

pip install mcp[cli]

Then, you can run the server.py script using the following command:

mcp dev server.py

You can also run server.py directly with Python:

python server.py

• Use python server.py to run in normal mode.
• Use mcp dev server.py for development to enjoy hot reloading and a better development experience.

⚠️ Important Note

When you run mcp dev server.py, you are starting the MCP Inspector and its proxy server (default port 6277), rather than directly running the FastMCP server defined in your server.py. The MCP Inspector uses port 6277 and will not use the port 8050 specified in server.py by default.

If you want your FastMCP server to listen on port 8050 defined in server.py, you should execute: python server.py

The mcp dev command is designed specifically for developing and debugging the MCP Inspector. If you want to connect to the Inspector, use the proxy port (6277). If you want your server to listen on port 8050, run python server.py directly.

🏃‍♀️ Running the Client

STDIO Client

Start the server as a subprocess and connect to it via stdio transport. This is useful for testing and debugging.

python client_stdio.py

SSE Client

Connect to the server via sse transport. This is suitable for real-time updates and notifications.

python client_sse.py

🔗 Links

• Server Development Quick Start
• Client Development Quick Start