Simple MCP Server

A basic implementation of a Model Context Protocol (MCP) server using TypeScript and Node.js.

Features

• Echo Tool: Echoes back any message you send
• Add Numbers: Adds two numbers together
• Current Time: Returns the current timestamp

Setup

1. Install dependencies:

   npm install
   

2. Build the project:

   npm run build
   

3. Run the server:

   npm start
   

   Or for development:

   npm run dev
   

Usage

The server communicates via stdio and implements the MCP protocol. It can be used with any MCP-compatible client.

Available Tools

1. echo

   • Description: Echo back the provided message
   • Parameters: message (string)

2. add_numbers

   • Description: Add two numbers together
   • Parameters: a (number), b (number)

3. get_current_time

   • Description: Get the current time
   • Parameters: none

Configuration

The server can be configured by modifying the SimpleMCPServer constructor in src/index.ts.

Architecture

• src/index.ts: Main server implementation
• src/types.ts: Type definitions
• Uses the official MCP SDK for protocol handling
• Communicates via stdio transport

Development

To extend this server:

1. Add new tools to the ListToolsRequestSchema handler
2. Implement the tool logic in the CallToolRequestSchema handler
3. Add proper error handling and validation
4. Update the tool schema as needed