MCP Server Sample

@antonioscapellato

Repository

Basic information

About MCP Server Sample

MCP Server Sample

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

MCP Server Sample config

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

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

MCP Server Sample tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

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).

How can I extend this server?

Add more `@mcp.tool()` or `@mcp.resource()` decorators with your own functions, following the patterns shown in the quickstart code.

Comments

More Other MCP servers

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K