SSE Calculator MCP Server

What is SSE Calculator MCP Server?

A stateful calculator server that uses Server-Sent Events (SSE) for real-time communication and implements the Model Context Protocol (MCP) for integration with AI assistants. It provides a web-based calculator interface and tracks calculation history per session.

How to use SSE Calculator MCP Server?

Install Node.js v14+ and npm v6+, clone the repository, run npm install, then start the server with npm run start:dev. Open http://localhost:3000 in a browser to access the calculator interface. For MCP integration, add the provided configuration to your MCP settings file, pointing to the SSE stream URL.

Key features of SSE Calculator MCP Server

• Real-time calculator operations via Server-Sent Events
• Stateful sessions for ongoing calculations
• History tracking for all calculations per session
• Web-based calculator interface
• MCP integration for AI assistant compatibility
• Built with NestJS for modular architecture

Use cases of SSE Calculator MCP Server

• AI assistants performing arithmetic operations with persistent session state
• Demonstrating SSE-based real-time data streaming in a calculator application
• Testing MCP client integration with a simple, stateful service
• Multi-step calculations where history is needed for review or debugging

FAQ from SSE Calculator MCP Server

What is the SSE Calculator MCP Server and how does it integrate with AI assistants?

It is a real-time calculator server that implements MCP, allowing AI assistants to send calculation requests and receive results over an SSE stream.

What are the prerequisites and how do I install it?

You need Node.js v14+ and npm v6+. Install by cloning the repository and running npm install.

How do I connect to the server from an MCP client?

Add the server’s URL (e.g., http://localhost:3000/calculator/stream) to your MCP settings file under mcpServers, along with optional timeout and allowed tools.

What calculator operations are supported?

Supported operations are add, subtract, multiply, divide, and clear. You send the operation and two numbers (a and b) via POST to /calculator/calculate/:sessionId.

How can I deploy this server to production?

You can deploy using Docker (with provided Dockerfile and docker-compose.yml), via Smithery.ai, on cloud platforms like Heroku or DigitalOcean, or self-hosted with SSL termination and load balancing.