Skip to main content
Glama
Simple MCP Server

Simple MCP Server

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:

  1. echo - Echoes back a message you provide

  2. calculator - Performs basic mathematical operations (add, subtract, multiply, divide)

  3. current_time - Returns the current date and time

Related MCP server: Model Context Protocol Demo

Prerequisites

  • Node.js 16 or higher

  • npm

Installation

  1. Clone this repository

  2. Install dependencies:

    npm install

Building

Build the TypeScript code:

npm run build

Running the Server

Start the server in development mode:

npm run dev

Or run the built version:

npm start

Testing 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 file

Tools 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 number

    • b (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 tools
calculatorC

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

    B3.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      1
      Apache 2.0
    • F
      license
      C
      quality
      D
      maintenance
      A 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
      -
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server implementation that provides basic utility tools including echo, uppercase text conversion, and mathematical calculations.
      3
      547 npm
      MIT