Basic

Provides deterministic tools for time, math, strings, random, and validation to assist language models with calculations, formatting, and checks.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "msilverblatt-basic-mcp": {
      "command": "bun",
      "args": [
        "run",
        "/path/to/basic-mcp/index.ts"
      ]
    }
  }
}

The basic MCP server offers a set of deterministic tools for common LLM challenges—time, math, counting, randomness, and validation. It provides reliable building blocks you can call from your MCP client to perform precise operations and validations, improving consistency across your workflows.

How to use

You can use the server in two main ways: run it locally as a stdio server or connect to it from Claude using a configured MCP server. In both cases you gain access to a suite of tools organized by category (Time, Math, Strings, Random, Validation) that you can invoke as needed in your prompts or automation.

How to install

Prerequisites: ensure you have Bun installed on your system. Bun is a fast JavaScript runtime and package manager used to run the MCP server.

bun install

Standalone usage

Run the MCP server locally in stand-alone mode. This starts the server so you can call its tools directly from your MCP client.

bun run index.ts

Claude Code usage

If you are using Claude, configure Claude to connect to the MCP server by adding an MCP server entry to your Claude configuration.

{
  "mcpServers": {
    "basic-tools": {
      "command": "bun",
      "args": ["run", "/path/to/basic-mcp/index.ts"]
    }
  }
}

Available tools

now

Get the current date and time with timezone support.

date_diff

Calculate the difference between two dates.

date_add

Add or subtract time from a date.

unix_timestamp

Convert between Unix timestamps and human-readable dates.

calculate

Evaluate mathematical expressions, including percentages, square roots, and trig functions.

convert_units

Convert values between units, such as kilometers to miles or Celsius to Fahrenheit.

statistics

Compute statistical measures like mean, median, mode, standard deviation, min, max, and sum.

count

Count characters, words, lines, bytes, sentences, and paragraphs in text.

hash

Generate cryptographic hashes (MD5, SHA-1, SHA-256, SHA-512).

uuid

Generate a UUID v4.

base64

Encode or decode data using base64 encoding.

regex_test

Test strings against regular expressions and patterns.

random_int

Produce cryptographically secure random integers.

random_float

Produce cryptographically secure random floating-point numbers.

random_choice

Select random item(s) from a list.

shuffle

Randomly shuffle an array using the Fisher-Yates algorithm.

validate

Validate formats like email, URL, IPv4, IPv6, UUID, JSON, and credit cards (Luhn).

json_parse

Parse JSON with optional path extraction.

url_parse

Parse a URL into components.

dns_lookup

Perform DNS lookups for A, AAAA, MX, TXT, NS, and CNAME records.