MCP Calculator Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
๐งฎ MCP Calculator Server โ Build Your First MCP Tool with TypeScript
A lightweight Model Context Protocol (MCP) server built in TypeScript using the official @modelcontextprotocol/sdk.
This server exposes a simple tool that performs addition of two numbers, showcasing how to build custom MCP-compatible tools.
๐ Features
Built using the official MCP SDK
Implements a simple calculator with an
addfunctionWritten in TypeScript
Easy to extend for new MCP tools
๐ Project Structure
my-calculator/
โ
โโโ src/
โ โโโ index.ts # Main server logic
โโโ package.json
โโโ tsconfig.json
โโโ README.mdโ๏ธ Setup Instructions
1. Clone the Repository
git clone https://github.com/<your-username>/mcp-calculator-server.git
cd mcp-calculator-server2. Install Dependencies
Make sure you have Node.js (v18+) and npm installed.
npm install3. Build the Project
npm run build4. Start the MCP Server
npm run startYou should see:
โ
MCP Calculator Server is running...๐ง How It Works
The project uses @modelcontextprotocol/sdk to create a minimal MCP server.
import { server } from "@modelcontextprotocol/sdk/server/stdio";
import { z } from "zod";
const s = server({
name: "MCP Calculator Server",
});
s.tool(
"add",
{
a: z.number(),
b: z.number(),
},
async ({ a, b }) => ({
content: [{ type: "text", text: `Result: ${a + b}` }],
})
);
s.start();
console.log("โ
MCP Calculator Server is running...");This registers an add tool, which takes two numbers (a, b) and returns their sum.
๐งฉ Testing (Optional)
If you want to test manually:
npm run startThen, you can connect this server to any MCP-compatible client (like Claude Desktop, ChatGPT with MCP, or other integrations).
๐งฑ Build Commands Reference
Command | Description |
| Compiles TypeScript into JavaScript |
| Starts the MCP server with ts-node |
| Installs all dependencies |
๐งฐ Tech Stack
TypeScript
Node.js
Model Context Protocol SDK
Zod (Schema validation)
๐ License
MIT License โ feel free to fork and modify.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for progressive tool usage at any scale (see https://klavis.ai)
A simple Typescript MCP server built using the official MCP Typescript SDK and smithery/cli. Thisโฆ
Related MCP Servers
- AlicenseBqualityDmaintenanceA simple TypeScript MCP server that provides two tools: one for greeting users with a customizable name and another for adding two numbers together.2MIT
- AlicenseNot gradedqualityDmaintenanceA minimal, production-ready MCP server with a simple addition calculator tool that demonstrates integration with the Model Context Protocol.1MIT
- AlicenseNot gradedqualityDmaintenanceA demonstration MCP server built in TypeScript that shows how to implement stdio-based communication for integration with MCP clients. Serves as a template for building custom MCP servers with strong typing and maintainability.ISC
- FlicenseCqualityDmaintenanceA demonstration MCP server that provides a simple addition tool for learning how to create and deploy servers following the Model-Context-Protocol specification. Serves as a basic example for developers getting started with MCP server development.1-