home / mcp / my little mcp server

My Little MCP Server

Provides MCP endpoints to fetch current Korean time and generate random numbers with configurable ranges.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "drdudda-org-my-little-mcp": {
      "url": "http://localhost:8004/mcp"
    }
  }
}

This MCP server exposes two practical actions you can use from any MCP client: fetch the current time in Korea Standard Time and generate a random number within a configurable range. It is simple to run, easy to integrate, and stays lightweight with pure MCP SDK tooling.

How to use

You can access two core actions from an MCP client: get_current_time and get_random_number. Use get_current_time to obtain the current date and time in Korea, with formats including locale, iso, and timestamp. Use get_random_number to obtain a random integer between 1 and 50 by default, or adjust the range with min and max options. When you call these actions, you receive a structured response that you can display in your UI or react to in your automations.

How to install

Prerequisites you need before starting: Node.js 18.0.0 or newer and TypeScript 5.0+. These ensure the server compiles and runs with type safety.

# Install dependencies
npm install

# Build the server
npm run build

Additional setup and usage notes

Run the server using one of the standard transport options. For local development with stdio transport, start in development mode or production mode as shown below. For HTTP transport, use the corresponding HTTP start commands. If you need to run with a custom port, use the appropriate dev command with port configuration.

# stdio transport (development)
npm run dev

# stdio transport (production)
npm start

# HTTP transport (development on port 8004)
npm run dev:http

# HTTP transport (production on port 8004)
npm run start:http

# Custom port for HTTP in development
npm run dev -- --transport=http --port=8005

Testing and quick checks

To test manually, run the server in the background or in a separate terminal, then make HTTP requests to the health or root endpoints, or use an MCP Inspector tool to verify responses.

# Start HTTP transport in development
npm run dev:http

# Health check (example, adjust URL as needed)
curl http://localhost:8004/health

Available tools

get_current_time

Fetches current date and time in Korea Standard Time in requested formats: locale, iso, or timestamp.

get_random_number

Generates a random integer within a configurable range, defaulting to 1–50 but adjustable with min and max.