Basic Math MCP Server Q8t

🚀 Basic Math MCP Server

A simple yet powerful MCP server built with the FastMCP framework, supporting basic mathematical operations such as addition, subtraction, multiplication, and division. It can be used directly in Claude Desktop or any MCP-compatible environment.

🚀 Quick Start

This is a minimal yet complete MCP server that provides basic arithmetic functions. You can follow the installation steps below and integrate it with Claude Desktop to start using it.

✨ Features

What is MCP?

MCP (Model Context Protocol) is an open - source standard developed by Anthropic, which allows external tools, APIs, or scripts to interface with large language models (LLMs) like Claude in a structured and interactive manner.

Through MCP, developers can:

• Build custom tools accessible to language models.
• Extend Claude's functionality using Python scripts or microservices.
• Share structured data or custom responses via @tool() and @resource() decorators.

What is a Custom MCP Server?

Custom MCP servers are Python services implemented using the mcp-server library and comply with the MCP specification. These servers:

• Define callable tools (@tool) for calculations or automation operations.
• Host resources (@resource) such as documents or reference data.
• Run locally or remotely, responding to requests from MCP clients like Claude Desktop.

MCP servers enable low - latency, secure, and contextual integration between language models and your code.

What We Built

This project exposes the following tools and resources:

Tools:

• add(a, b) – Returns the sum of two numbers.
• subtract(a, b) – Returns the result of subtracting b from a.
• multiply(a, b) – Returns the product of a and b.
• divide(a, b) – Returns the result of dividing a by b, supporting handling of division - by - zero exceptions.

Resources:

• math_help() – Returns examples of mathematical operations and links to documentation.

📦 Installation

Prerequisites

Before proceeding, ensure you meet the following requirements:

• Install Python 3.6 or higher.
• Install Claude Desktop and configure the API key.
• Be familiar with command - line interface (CLI) operations.

Installation Steps

To use this MCP server, follow these steps:

Step 1: Install uv

Run the following commands in the terminal to install the uv runtime:

# On macOS/Linux:
curl -o /usr/local/bin/uv https://github.com/samth/uv/releases/download/v1.0.0/uv-macos-x86_64 && chmod +x /usr/local/bin/uv

# On Windows (requires WSL support):
powershell.exe (iwr https://github.com/samth/uv/releases/download/v1.0.0/uv-win-x86_64).Content | Out-File -Path %ProgramFiles%\uv\uv.exe

Step 2: Install and Run the MCP Server

Use the uv runtime to install and start the server:

uv run mcp_server.py

📚 Documentation

Integration with Claude Desktop

To make Claude Desktop recognize your MCP server, follow these steps:

1. Open the claudia.json file (usually located in the .config/claudia/ directory under the user's home directory).
2. Add or modify the following content:

{
    "mcpServers": [
        {
            "name": "math_server",
            "url": "http://localhost:8000"
        }
    ]
}

3. If you already have other servers, ensure the new configuration is correctly separated from existing entries.

💻 Usage Examples

Basic Usage

To test the functionality of the MCP server, you can use the following query directly in Claude Desktop:

Call add(2, 3)

Advanced Usage

To get help information for mathematical operations, call:

Call math_help()

This function will return a JSON - formatted response containing examples and documentation links.

📄 Useful Links

• FastMCP framework
• Claude Desktop documentation
• uv runtime download