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

🚀 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

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K