A simple calculator server for performing basic arithmetic operations.
A Model Context Protocol (MCP) server built with mcp-framework.
# Install dependencies
npm install
# Build the project
npm run build
calculator/
├── src/
│ ├── tools/ # MCP Tools
│ │ └── ExampleTool.ts
│ └── index.ts # Server entry point
├── package.json
└── tsconfig.json
The project comes with an example tool in src/tools/ExampleTool.ts
. You can add more tools using the CLI:
# Add a new tool
mcp add tool my-tool
# Example tools you might create:
mcp add tool data-processor
mcp add tool api-client
mcp add tool file-handler
Example tool structure:
import { MCPTool } from "mcp-framework";
import { z } from "zod";
interface MyToolInput {
message: string;
}
class MyTool extends MCPTool<MyToolInput> {
name = "my_tool";
description = "Describes what your tool does";
schema = {
message: {
type: z.string(),
description: "Description of this input parameter",
},
};
async execute(input: MyToolInput) {
// Your tool logic here
return `Processed: ${input.message}`;
}
}
export default MyTool;
Update your package.json:
name
is unique and follows npm naming conventionsversion
description
, author
, license
, etc.bin
points to the correct entry fileBuild and test locally:
npm run build
npm link
calculator # Test your CLI locally
Login to npm (create account if necessary):
npm login
Publish your package:
npm publish
After publishing, users can add it to their claude desktop client (read below) or run it with npx
## Using with Claude Desktop
### Installing via Smithery
To install Calculator for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@QuantGeekDev/mcp-add-sse):
```bash
npx -y @smithery/cli install @QuantGeekDev/mcp-add-sse --client claude
Add this configuration to your Claude Desktop config file:
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"calculator": {
"command": "node",
"args":["/absolute/path/to/calculator/dist/index.js"]
}
}
}
Add this configuration to your Claude Desktop config file:
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"calculator": {
"command": "npx",
"args": ["calculator"]
}
}
}
npm run build
to compileSimple unofficial MCP server to track time via Toggl API
Manages configurations for MCP clients, automatically detecting file paths based on OS and client.
Notion official MCP server
Monitor team productivity, usage, and spending for AI assistants using the Cursor Admin API.
Generate high-quality text-to-speech and text-to-voice outputs using the DAISYS platform.
Trello Desktop MCP server that enables Claude Desktop to interact with Trello boards, cards, lists, and team members through natural language commands.
A CLI tool to synchronize MCP (Model Context Protocol) settings across multiple AI coding tools.
Interact with the HireBase Job API to manage job listings and applications.
Interact with and manage your Bitrix24 CRM instance through a powerful set of tools.
A command-line tool to fetch Google Calendar schedules and convert them into custom prompts or text snippets using a template engine.