rpn-mcp

MCP server that exposes an RPN calculator

Install

pip install rpn-mcp

Usage

rpn-mcp

The server uses stdio transport for MCP protocol communication.

MCP Tools

evaluate

Evaluate an RPN (Reverse Polish Notation) expression.

{
  "name": "evaluate",
  "arguments": {
    "expression": "3 4 +",
    "show_stack": true
  }
}

Operators:

• + - Add

• - - Subtract

• - - Multiply

• / - Divide

• ** - Power

• % - Modulo

Commands:

• clear - Clear the stack

• dup - Duplicate top of stack

• swap - Swap top two elements

Examples:

• 3 4 + returns 7

• 10 5 2 + * 2 - returns 32

• 3 2 / returns 1.5

clear

Clear the calculator stack.

{
  "name": "clear",
  "arguments": {}
}

Development

git clone https://github.com/dclavijo/rpn-mcp.git
cd rpn-mcp
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

MCP Registry

mcp-name: io.github.dclavijo/rpn-mcp