Calculator MCP Agent

A LangChain agent that connects to a custom MCP (Model Context Protocol) server which exposes a simple calculator tool. The agent can evaluate mathematical expressions by calling the calculator tool over MCP.

How it works

• mcqcalc.py — a FastMCP server that exposes a calculator tool (and a prompt template) over streamable HTTP.

• mcp_calc.ipynb — a notebook that starts a LangChain agent, connects to the MCP server, and uses a locally hosted Ollama model to answer math questions.

Related MCP server: Calculator MCP

Running it

Running this project takes two steps, in two separate terminals.

1. Start the MCP server in one terminal:

   python mcqcalc.py

   This launches the calculator MCP server (listening on port 8000).

2. Run the notebook in another terminal (or your editor):

   Open and run mcp_calc.ipynb. It connects to the running MCP server and drives the agent.

Ollama configuration

The notebook's base_url for Ollama points to a private local network address specific to my setup. Before running the notebook, replace that base_url with your own Ollama instance URL (for example, http://localhost:11434 if you run Ollama locally).

Setup

Install dependencies:

pip install -r requirements.txt

Create a .env file for any required environment variables (it is git-ignored).