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

FAQ from Mcp Server Demo

What tools does the demo server provide?

The demo server exposes a single tool called calculate_sum which adds two numbers (a and b) and returns a text result.

How do I run the servers?

Use uv run python server/demo.py, uv run python server/doc_assistant.py, or uv run python server/us_weather.py from the repository root.

What protocol version is used?

The server and client exchange messages using MCP protocol version 2025-03-26.

Can I test the server without the client?

Yes. Start the server with uv --directory <path> run <filename>.py and type JSON‑RPC messages directly into the console to see responses.

—

—

—