MCP.so
Sign In

Introduction to MCP

@LiteObject

Repository

About Introduction to MCP

Minimal MCP server/client example demonstrating basic calculator operations via SSE and stdio transports.Minimal MCP server/client example demonstrating basic calculator operations via SSE and stdio transports.

#python#ai#mcp#mcp-server#modelcontextprotocol#mcp-client

Config

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

{
  "mcpServers": {
    "introduction-to-mcp": {
      "command": "python",
      "args": [
        "server.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 Introduction to MCP?

A minimal MCP (Model Context Protocol) server and client example that demonstrates basic calculator operations. It supports both SSE and stdio transports and is intended for developers learning how to build and test MCP servers and clients.

How to use Introduction to MCP?

Install dependencies with pip install -r requirements.txt and the MCP CLI with pip install mcp[cli]. Run the server using mcp dev server.py (starts the MCP Inspector proxy on port 6277) or python server.py (runs the FastMCP server directly on port 8050). Then launch a client script: python client_stdio.py for stdio transport or python client_sse.py for SSE transport.

Key features of Introduction to MCP

  • Provides a minimal calculator example (add, subtract, multiply, divide)
  • Supports both stdio and SSE transports
  • Includes a ready-to-run client for each transport
  • Uses FastMCP for server implementation
  • Offers a development mode with hot-reloading via mcp dev

Use cases of Introduction to MCP

  • Learning how to set up and run an MCP server and client
  • Testing basic calculator operations with different transport protocols
  • Debugging MCP interactions using the Inspector proxy in development mode
  • Understanding the difference between mcp dev and direct Python execution

FAQ from Introduction to MCP

What transports are supported?

The server supports stdio (client launched as subprocess) and SSE (client connects via HTTP event stream).

How do I run the server on port 8050 as defined in server.py?

Execute python server.py directly. The mcp dev command runs the MCP Inspector on port 6277, not on the port defined in server.py.

What is the difference between mcp dev server.py and python server.py?

mcp dev server.py starts the MCP Inspector with a proxy server on port 6277 for development and debugging. python server.py runs your FastMCP server directly on the port specified in the code (8050).

What dependencies are required?

The project lists dependencies in requirements.txt and requires the mcp package (install with pip install mcp[cli]).

Frequently asked questions

What transports are supported?

The server supports stdio (client launched as subprocess) and SSE (client connects via HTTP event stream).

How do I run the server on port 8050 as defined in server.py?

Execute `python server.py` directly. The `mcp dev` command runs the MCP Inspector on port 6277, not on the port defined in server.py.

What is the difference between `mcp dev server.py` and `python server.py`?

`mcp dev server.py` starts the MCP Inspector with a proxy server on port 6277 for development and debugging. `python server.py` runs your FastMCP server directly on the port specified in the code (8050).

What dependencies are required?

The project lists dependencies in `requirements.txt` and requires the `mcp` package (install with `pip install mcp[cli]`).

Comments

Basic information

Category

Other

Transports

stdio

Author

LiteObject

More Other MCP servers

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K