MCP server/other

MCP Calculator Demo MCP Server

A sample MCP server that provides basic arithmetic tools

FisherSkyi/mcp-demo ↗by FisherSkyiupdated
Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1

Prepare the server locally

Run this once before adding it to Claude Code.

npm install
npm start
2

Register it in Claude Code

claude mcp add mcp-calculator-demo -- node /path/to/server.mjs

Replace any placeholder paths in the command with the real path on your machine.

3

Make your agent remember this setup

mcp-calculator-demo's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.

npx conare@latest

Free · one command · indexes the sessions already on disk. Set up in the browser instead →

What it does

  • Provides basic arithmetic operations
  • Implements the Model Context Protocol
  • Supports addition, subtraction, multiplication, and division
  • Demonstrates client-server communication

Tools 4

addAdds two numbers together
subtractSubtracts the second number from the first
multiplyMultiplies two numbers
divideDivides the first number by the second

Try it

What is 154 plus 89?
Calculate 500 divided by 25.
Multiply 12 by 12 and then subtract 50.
What is the result of 100 minus 33?
Original README from FisherSkyi/mcp-demo

MCP Demo

This repository contains demo projects showcasing the use of the Message Communication Protocol (MCP) in different scenarios.

Projects

1. Calculator

A simple calculator service with a client and server implementation.

  • Files:
    • demo-client.mjs: Example client for the calculator service
    • server.mjs: Calculator server
    • package.json, README.md

2. MCP Client (TypeScript)

Offical demo from MCP documentation

A TypeScript-based client for interacting with MCP services.

  • Files:
    • index.ts: Main client code
    • build/index.js: Compiled output
    • .env: Environment configuration
    • log/session1.txt: Example session log
    • package.json, tsconfig.json

[!NOTE] Need to set ANTHROPIC_API_KEY in .env to run the client. The credit from Anthropic is NOT free.

3. Weather

Offical demo from MCP documentation

A weather information service using MCP.

  • Files:
    • src/index.ts: Main source code
    • build/index.js: Compiled output
    • package.json, tsconfig.json

Getting Started

Each project contains its own dependencies and setup.
Navigate into a project folder and run:

npm install
npm start

or for TypeScript projects:

npm install
npm run build
npm start

License

MIT

Frequently Asked Questions

What are the key features of MCP Calculator Demo?

Provides basic arithmetic operations. Implements the Model Context Protocol. Supports addition, subtraction, multiplication, and division. Demonstrates client-server communication.

What can I use MCP Calculator Demo for?

Testing MCP server connectivity in Claude Desktop. Learning how to implement custom tools in MCP. Verifying arithmetic capabilities within an AI assistant.

How do I install MCP Calculator Demo?

Install MCP Calculator Demo by running: npm install && npm start

What MCP clients work with MCP Calculator Demo?

MCP Calculator Demo works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Conare · memory for coding agents

Turn this server into reusable context

Keep MCP Calculator Demo docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Set up free$npx conare@latest