MCP Server Demo

What is Mcp Server Demo?

Mcp Server Demo is a starter repository for building and testing MCP (Model Context Protocol) servers and clients. It includes three example servers (demo, document assistant, and US weather) and a corresponding client, intended for developers learning the protocol.

How to use Mcp Server Demo?

Run any MCP server with uv run python server/<filename>.py (e.g., uv run python server/demo.py). A client can be started with uv run python client/doc_assistant_client.py. For manual end‑to‑end testing, start a server with uv --directory <path> run <filename>.py and then type JSON‑RPC messages into the stdout console.

Features of Mcp Server Demo

• Three ready‑to‑run example MCP servers
• One MCP client example (document assistant)
• Manual JSON‑RPC message sequence for learning
• Demonstrates initialize, tools/list, and tools/call lifecycle
• Includes a calculate_sum tool with input schema
• Uses protocol version 2025-03-26

Use cases of Mcp Server Demo

• Learn the MCP client–server handshake and message flow
• Experiment with tool definitions and tool calls in a controlled environment
• Prototype a custom MCP server by copying and modifying an example
• Test tool interaction manually before building an automated client