Custom

You can run a lightweight MCP server that exposes tools over HTTP and, optionally, Server-Sent Events for real-time state. It includes handy utilities you can call remotely, with built-in safety features and Redis-backed SSE state management when you enable it.

How to use

You interact with the server through an MCP client over HTTP or SSE. Start the server locally, then request the available tools, list them, and run a tool like echo, get-current-time, or calculate. The HTTP transport is stateless and simple to use for quick checks, while SSE provides a streaming channel with Redis-based state management for more interactive sessions. Use the tools to perform common tasks such as testing responses, obtaining the current time, or evaluating safe mathematical expressions.

How to install

Prerequisites include Node.js 18 or later and a modern package manager. You can use npm or yarn. Docker is optional if you plan to run Redis locally.

npm install

npm run setup

The automated setup creates environment configuration, sets up Redis if available, and starts the development server. If you prefer to start manually, run the development server after setup is complete.

npm run dev

Additional notes

The server exposes an HTTP endpoint at /mcp for stateless requests and an SSE endpoint at /sse for real-time streaming that can use Redis for state management. You can test locally at http://localhost:3000.

Configuration and testing

You can customize Redis usage via environment variables. If you want local Redis, ensure it is running and reachable. For production-grade setups, you can use Upstash Redis by providing the REST URL and token.

Security and reliability

Rate limiting is enabled (100 requests per minute) to protect the server. Input is sanitized and validated, and mathematical expressions are evaluated safely.

Testing

Quickly verify HTTP transport functionality or SSE transport (with Redis) using the provided tests, or manually exercise the HTTP endpoint with curl to list and call tools.

AI tool integrations

You can configure Claude Desktop or Cursor to connect to the MCP server so your AI workflows can leverage the available tools. Use the dedicated configuration values to point to the HTTP or SSE endpoints.

Available tools

echo

Echoes back the provided message to verify connectivity and response structure.

get-current-time

Returns the current timestamp and ISO date for synchronization or logging.

calculate

Safely evaluates a basic mathematical expression and returns the result.