Overview
What is Calculator SSE?
Calculator SSE is a demo Node.js + TypeScript MCP (Model Context Protocol) server that exposes simple calculation tools—BMI (Body Mass Index) and addition—via Server-Sent Events (SSE) transport. It is designed for integration into GitHub Copilot Agent and Microsoft Copilot Studio for real-time streaming responses.
How to use Calculator SSE?
Install dependencies with npm install, compile TypeScript with npm run build, then start the server with npm run start (default port 3001). The SSE endpoint is at GET /sse. For GitHub Copilot Agent, add an MCP server entry in .vscode/mcp.json with type sse and url http://localhost:3001/sse. For Microsoft Copilot Studio, set up a custom connector using the provided Swagger specification.
Key features of Calculator SSE
- SSE (Server-Sent Events) transport for real-time responses
- BMI Calculator tool (calculate-bmi)
- Addition tool (calculate-sum)
- Ready for GitHub Copilot Agent integration
- Ready for Microsoft Copilot Studio integration
- Azure App Service deployment support
Use cases of Calculator SSE
- Prototyping MCP server integration with GitHub Copilot Agent
- Demonstrating MCP tool integration in Microsoft Copilot Studio
- Testing SSE-transport MCP servers in local development
- Learning MCP SDK and best practices with a simple calculator example
FAQ from Calculator SSE
What tools does Calculator SSE provide?
It provides two tools: calculate-bmi (inputs: weightKg, heightM) and calculate-sum (inputs: a, b), both returning text responses.
How do I integrate Calculator SSE with GitHub Copilot Agent?
In VSCode, open the Command Palette, select "Add MCP Server", then update .vscode/mcp.json with "type": "sse" and "url": "http://localhost:3001/sse".
How do I integrate Calculator SSE with Microsoft Copilot Studio?
Use a custom connector based on the Swagger specification provided in the README. Navigate to Copilot Studio > Actions > Custom connector, find the MCP Server Action, and configure it with the SSE endpoint.
What transport does Calculator SSE use?
It uses Server-Sent Events (SSE) via the GET /sse endpoint, which returns a full URI for subsequent MCP interactions.
Is Calculator SSE production-ready?
No. It is an unsupported, experimental demo server provided "as is" with no warranties. It is not intended for production use.
