Simple MCP Server
Requires Node.js for running the MCP server, with the server implementation written for the Node.js runtime.
Implements the MCP server using TypeScript for type safety, requiring compilation before execution.
Utilizes Zod for runtime type validation of data exchanged between the MCP server and clients.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Simple MCP Server calculate 42 divided by 7"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Simple MCP Server
A simple Model Context Protocol (MCP) server example that demonstrates basic MCP functionality.
What it does
This MCP server provides three basic tools:
echo - Echoes back a message you provide
calculator - Performs basic mathematical operations (add, subtract, multiply, divide)
current_time - Returns the current date and time
Related MCP server: Model Context Protocol Demo
Prerequisites
Node.js 16 or higher
npm
Installation
Clone this repository
Install dependencies:
npm install
Building
Build the TypeScript code:
npm run buildRunning the Server
Start the server in development mode:
npm run devOr run the built version:
npm startTesting with Claude Desktop
To test this MCP server with Claude Desktop, add the following configuration to your claude_desktop_config.json:
Windows
Location: %APPDATA%\Claude\claude_desktop_config.json
macOS/Linux
Location: ~/Library/Application Support/Claude/claude_desktop_config.json
Configuration:
{
"mcpServers": {
"simple-mcp-server": {
"command": "node",
"args": ["/absolute/path/to/your/project/build/index.js"]
}
}
}Replace /absolute/path/to/your/project/ with the actual path to your project directory.
Project Structure
├── src/
│ └── index.ts # Main server implementation
├── build/ # Compiled JavaScript (generated)
├── .github/
│ └── copilot-instructions.md # Copilot instructions
├── .vscode/
│ └── mcp.json # VS Code MCP configuration
├── package.json # Project configuration
├── tsconfig.json # TypeScript configuration
└── README.md # This fileTools Available
echo
Description: Echo back the provided message
Parameters:
message(string): The message to echo back
calculator
Description: Perform basic mathematical operations
Parameters:
operation(enum): One of 'add', 'subtract', 'multiply', 'divide'a(number): The first numberb(number): The second number
current_time
Description: Get the current date and time
Parameters: None
Example Usage
Once connected to an MCP client like Claude Desktop, you can use commands like:
"Echo back the message 'Hello World'"
"Calculate 15 plus 25"
"What's the current time?"
Development
This project is set up with:
TypeScript for type safety
Zod for runtime type validation
MCP SDK for protocol compliance
ES modules support
Available Tools
3 toolscalculatorC
Perform basic mathematical operations
Inputs: operation (required), a (required), b (required).
current_timeA
Get the current date and time
Inputs: no named parameters.
echoB
Echo back the provided message
Inputs: message (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose with no overlap: calculator handles math, current_time provides time/date, and echo returns input messages. An agent can easily tell them apart based on their unique functions.
The naming is mostly consistent with a clear noun-based pattern (calculator, current_time, echo), though 'current_time' uses snake_case while 'calculator' and 'echo' are single words, which is a minor deviation from perfect uniformity.
With 3 tools, the count is well-scoped for a simple utility server, providing a focused set of basic operations without being too sparse or overwhelming for its apparent purpose.
For a simple utility server, the tools cover basic needs (math, time, messaging) with no obvious dead ends, though minor gaps like unit conversion or advanced time functions could exist but are not critical for this scope.
Maintenance
Related MCP Connectors
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA demonstration implementation of the Model Context Protocol server that facilitates communication between AI models and external tools while maintaining context awareness.-
- AlicenseNot gradedqualityDmaintenanceA demonstration server for the Model Context Protocol (MCP) that exposes calculator and Yahoo Finance tools, allowing LLMs to interpret natural language requests and make tool calls via the MCP standard.1Apache 2.0
- FlicenseCqualityDmaintenanceA demonstration server based on Model Context Protocol (MCP) that showcases how to build custom tools for AI assistants, providing mathematical calculation and multilingual greeting capabilities.3-
- AlicenseBqualityDmaintenanceA Model Context Protocol server implementation that provides basic utility tools including echo, uppercase text conversion, and mathematical calculations.3547 npmMIT