Multi Tool

You run a flexible MCP server that exposes calculator tools, useful resources, and prompt templates. It supports local stdio workflows for running as a subprocess and Server-Sent Events (SSE) for remote clients, making it easy to integrate with a variety of MCP clients and tools.

How to use

You can run the server in stdio mode for local work with tools like Claude Desktop, or enable SSE to serve remote HTTP clients. Start by launching the server in stdio when you want a fast, local integration, or start SSE to expose a real-time HTTP endpoint that MCP clients can connect to.

Primary capabilities include a suite of Calculator Tools (add, subtract, multiply, divide, power, square_root, factorial, calculate_percentage), access to the TypeScript SDK MCP documentation via a dedicated resource URI, and a Prompt for generating executive meeting summaries from transcripts.

How to install

Prerequisites include Python 3.10 or newer and the uv package installer for Python workflows.

# 1) Install Python
# Windows
# - Install from python.org and ensure Python is added to PATH

# macOS/Linux (example)
# - Use a suitable method to install Python 3.12+ and ensure python3 and pip3 are available

2. Install uv and set up the project environment.

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

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Verify
uv --version

3. Clone the project, initialize, create a virtual environment, and install MCP CLI.

# Clone the repository
git clone <your-repo-url>
cd mcp-multi-tool-server

# Initialize project
uv init --no-readme

# Create virtual environment
uv venv

# Activate virtual environment
# Windows PowerShell:
.\.venv\Scripts\Activate.ps1
# Windows CMD:
.venv\Scripts\activate.bat
# macOS/Linux:
source .venv/bin/activate

# Install dependencies
uv add "mcp[cli]"

Additional sections

Configuration for transport modes is provided to let you choose stdio for local usage or SSE for remote connections. The server can be started in stdio mode with a simple Python invocation or accessed via SSE at a dedicated HTTP endpoint.

You can connect to Claude Desktop by configuring a path to run the server in stdio mode and then restarting Claude Desktop to load the available tools, resources, and prompts.

If you need a quick start, you can run the server in stdio mode using the following command after you have activated the virtual environment.

# Activate virtual environment
source .venv/bin/activate  # macOS/Linux
# or .\.venv\Scripts\Activate.ps1  # Windows PowerShell

# Run the server in stdio mode
python server.py

Available tools

add

Add two numbers and return the result as a float.

subtract

Subtract the second number from the first and return the result as a float.

multiply

Multiply two numbers and return the result as a float.

divide

Divide the first number by the second and return the result as a float. Raises an error if the divisor is zero.

power

Raise a number to a specified exponent and return the result as a float.

square_root

Calculate the square root of a number and return the result as a float. Raises an error if the number is negative.

factorial

Compute the factorial of a non-negative integer and return it as an integer. Raises an error if the input is negative.

calculate_percentage

Compute what percentage part is of the whole and return the result as a float. Raises an error if the whole is zero.