MCP Server Sample

Name: MCP Server Sample
Author: antonioscapellato

@antonioscapellato

Repository

About MCP Server Sample

MCP Server Sample

#mcp #mcp-server #model-context-protocol

Basic information

Config

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

{
  "mcpServers": {
    "mcp-server-sample-antonioscapellato": {
      "command": "uv",
      "args": [
        "run",
        "mcp"
      ]
    }
  }
}

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 MCP Server Sample?

MCP Server Sample is an educational implementation of a Model Context Protocol (MCP) server. It demonstrates how to build a functional MCP server that integrates with various LLM clients.

How to use MCP Server Sample?

Install Python 3.10 or higher and the MCP SDK 1.2.0 or higher. Use uv or pip to add "mcp[cli]" to your project. Create a server script using FastMCP, then run it with mcp dev server.py for testing or mcp install server.py to use with Claude Desktop.

Key features of MCP Server Sample

Demonstrates a fully functional MCP server with tools and resources
Built with FastMCP for minimal boilerplate
Provides a calculator tool (add) and a dynamic greeting resource (greeting://{name})
Easy integration with MCP‑compatible clients like Claude Desktop
Serves as a reference for building custom MCP servers

Use cases of MCP Server Sample

Learning how to create and deploy MCP servers
Prototyping LLM integrations with custom tools and data sources
Testing the MCP protocol in a safe, minimal environment
Demonstrating the MCP client‑server architecture in workshops or tutorials

FAQ from MCP Server Sample

What is MCP?

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. It works like a USB‑C port for AI applications, connecting models to data sources and tools.

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 install and run the server?

Add "mcp[cli]" to your project with uv add "mcp[cli]" or pip install "mcp[cli]". Write a server.py file, then run mcp dev server.py for interactive testing or mcp install server.py to register with Claude Desktop.

What capabilities does this server demonstrate?

It demonstrates two core MCP capabilities: a tool (add that sums two integers) and a resource (greeting://{name} that returns a personalized greeting).