demo-mcp-server

Lnxtanx/demo-mcp-server

3.2

If you are the rightful owner of demo-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

This is a demo MCP server project created by Vivek using the FastMCP framework, designed to provide basic utility tools for Claude Desktop.

Tools
2
Resources
0
Prompts
0

Demo MCP Server

My first local MCP (Model Context Protocol) server project created by Vivek.

Overview

This is a simple MCP server built with FastMCP that provides basic utility tools for Claude Desktop. It demonstrates the fundamentals of creating and deploying a local MCP server.

Features

The server provides two main tools:

🎲 Roll Dice

  • Function: roll_dice(n_dice: int = 1)
  • Description: Roll N six-sided dice and return the results
  • Usage: Perfect for games, random number generation, or decision making

➕ Add Numbers

  • Function: add_numbers(a: float, b: float)
  • Description: Add two numbers together
  • Usage: Simple arithmetic operations

Installation

  1. Install UV (if not already installed):

    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

  2. Install the server to Claude Desktop:

    uv run --with fastmcp fastmcp install claude-desktop main.py --name "Demo Server"

Development

To run the server in development mode:

uv run --with fastmcp fastmcp dev main.py

Usage in Claude Desktop

Once installed, you can use the tools directly in Claude Desktop:

  • "Roll 3 dice for me"
  • "Add 15.5 and 23.7"

Project Structure

first_local_server/
├── main.py          # Main MCP server implementation
├── pyproject.toml   # Project configuration
└── README.md        # This file

About

This project was created as a learning exercise to understand:

  • MCP (Model Context Protocol) basics
  • FastMCP framework usage
  • Local server development and deployment
  • Integration with Claude Desktop

Created by: Vivek
Project Type: First MCP Server
Framework: FastMCP
Date: October 2025