AI MCP Tools

A lightweight local MCP server demo built in Python.

This repository contains a small set of tool definitions for mcp, showing how to expose simple operations through a local MCP server and manage the environment with uv.

What this repo contains

• main.py: a minimal MCP server with five tools:

  • add(a, b)

  • subtract(a, b)

  • multiply(a, b)

  • divide(a, b)

  • long_process(steps)

• MCP.md: notes on MCP architecture and the main components of the protocol.

• pyproject.toml, uv.lock, and .venv/: the source configuration and environment state created through uv.

Related MCP server: Arithmuse

Why this setup

I used uv to initialize and manage the Python environment, keep dependencies locked, and keep the repo light and reproducible. The goal is a clean, easy-to-run demo rather than a copied template.

Getting started

1. Create or activate the virtual environment:

   uv venv .venv
   .\.venv\Scripts\Activate.ps1

2. Install dependencies:

   uv install

3. Run the MCP server locally:

   mcp dev main.py

Notes

• The repository is designed for local development and experimentation with MCP tools.

• uv.lock stores the exact dependency versions, so the environment can be reproduced.

• .gitignore excludes the virtual environment and Python cache files.

Quick commands

• uv init — initialize the project config with uv (already done)

• uv install — install packages and update the lock file

• uv venv .venv — create the local virtual environment

• mcp dev main.py — start the MCP tool server