MCP Server Example

What is MCP Server Example?

MCP Server Example is an educational implementation of a Model Context Protocol (MCP) server that demonstrates how to build functional MCP servers for integration with LLM clients. It is intended for developers learning to expose data and tools through the standardized MCP protocol using Python.

How to use MCP Server Example?

Install the uv package manager, create a project with uv init mcp-server, activate the virtual environment, install dependencies with uv add "mcp[cli]" httpx, and create main.py. Run the server with uv run main.py. Then configure an MCP host like Claude Desktop by editing its configuration file to point to the server using the uv command and absolute path to the project directory.

Key features of MCP Server Example

• Demonstrates MCP Resources, Tools, and Prompts
• Example implementation in Python 3.10+
• Uses the official MCP SDK (1.2.0+)
• Connects to Claude Desktop and other MCP hosts
• Serves as a tutorial companion for a video guide

Use cases of MCP Server Example

• Learning how to build an MCP server from scratch
• Prototyping custom tools and data access for LLMs
• Testing MCP client configurations (e.g., Claude Desktop)
• Understanding the MCP client-server architecture

FAQ from MCP Server Example

What is MCP?

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs, similar to a USB-C port for AI applications.

What are the system requirements?

Python 3.10 or higher, MCP SDK 1.2.0 or higher, and the uv package manager.

How do I connect this server to Claude Desktop?

Install Claude Desktop, then edit ~/Library/Application Support/Claude/claude_desktop_config.json to include a server entry with command: "uv" and args containing --directory, the absolute path to your project, run, and main.py. Restart Claude Desktop.

What capabilities does the server provide?

The server can expose three main types of MCP capabilities: Resources (file-like data), Tools (callable functions), and Prompts (pre-written templates).

What should I do if the server isn't picked up by Claude Desktop?

Check the configuration file path and permissions, verify the absolute path is correct, ensure uv is installed and accessible, and review Claude Desktop logs for error messages.