home / mcp / demo mcp server

Demo MCP Server

Exposes calculator tools, personalized greetings, and code review prompts via MCP in Python

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "bollam1818-mcpserver": {
      "command": "mcp",
      "args": [
        "dev",
        "server.py"
      ],
      "env": {
        "PYTHONWARNINGS": "ignore"
      }
    }
  }
}

MCP lets you attach structured context to language models, enabling apps to expose resources, tools, and prompts that an AI can invoke to perform tasks or fetch information. This server demonstrates how to build MCP endpoints in Python, run in development mode with hot reloading, and test interactions quickly.

How to use

You can use an MCP client to interact with the server by calling the available tools, resources, and prompts exposed by this server. The Calculator tools perform arithmetic, the Greeting resource provides personalized messages, and the Code Review prompts offer reusable templates for feedback. Start the server in development mode for rapid testing, then issue requests through your MCP client to perform calculations, retrieve greetings, or request code review prompts.

How to install

Prerequisites: Python 3.8+ and a virtual environment tool available on your system.

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

Additional notes

Development mode enables hot reloading and interactive testing. Use the MCP command to start the server in development mode, or run the server directly for a standard start. You can also install the server for Claude Desktop integration to streamline workflows.

Development workflow examples shown include starting in development mode and performing a direct start, as well as installing for Claude Desktop integration.

Development and usage tips

- Development mode is recommended for rapid iteration because it reloads changes automatically. - Direct execution is useful for a stable, standalone run without hot reloading. - If you want to integrate with Claude Desktop, install the server using the provided command.

Available tools

add

Add two integers and return the sum using the calculator tool.

multiply

Multiply two integers and return the product using the calculator tool.

calculate_bmi

Calculate body mass index from weight in kilograms and height in meters.