joembolinas/mcp-server-demo

3.1

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

This is a demonstration project for the Model Context Protocol (MCP) Python SDK, showcasing how to set up and run an MCP server.

MCP Server Demo

This is a demonstration project for the Model Context Protocol (MCP) Python SDK.

Prerequisites

Python 3.10 or higher
pip or uv package manager (recommended)

Setup

Setting up the virtual environment

# Create a virtual environment
python -m venv .venv

# Activate the virtual environment (Windows)
source .venv/Scripts/activate

# Install dependencies
pip install -e ".[dev]"

Using uv (recommended)

# Install dependencies using uv
uv sync --all-extras --dev

Running the MCP Server

To run the MCP server in development mode:

mcp dev main.py

This will start the MCP Inspector interface where you can interact with your MCP server.

Installing in Claude Desktop

If you have Claude Desktop installed, you can install this MCP server:

mcp install main.py

Development

Running Tests

pytest

Type Checking

pyright

Linting

ruff check .
ruff format .

Project Structure

main.py - The main MCP server implementation
pyproject.toml - Project configuration

Resources