trackmcp
Back to directory
bmorphism

slowtime-mcp-server

View on GitHub

A Model Context Protocol server for secure time-based operations with timing attack protection and timelock encryption

3 stars TypeScriptAI & Machine Learning Updated Oct 24, 2025

Documentation

Slowtime MCP Server

A Model Context Protocol server for secure time-based operations with timing attack protection and timelock encryption.

code
┌──────────────┐
                                     │   Claude     │
                                     │   Desktop    │
                                     └──────┬───────┘
                                            │
                                            ▼
┌──────────────┐                    ┌──────────────┐
│   Timelock   │◄──────────────────►│   Slowtime   │
│  Encryption  │                    │     MCP      │
└──────────────┘                    │    Server    │
                                    └──────┬───────┘
                                           │
                                           ▼
┌──────────────┐                   ┌──────────────┐
│    Timing    │◄─────────────────►│  Interval    │
│ Protection   │                   │   Manager    │
└──────────────┘                   └──────────────┘

Features

Time Fuzzing & Security

code
Input Time ──┐
            ┌▼─────────────┐
            │ Random Fuzz  │     ┌─────────────┐
            │ (100-5000ms) ├────►│ Jittered    │
            └─────────────┘     │ Timestamp    │
                               └─────────────┘

Timelock Encryption Flow

code
Data ───────┐
           ┌▼────────────┐    ┌────────────┐    ┌────────────┐
           │  Encrypt    │    │  Interval  │    │ League of  │
           │   with     ├───►│ Duration   ├───►│  Entropy   │
           │ Timelock   │    │ Remaining  │    │  Network   │
           └────────────┘    └────────────┘    └────────────┘

Interval Management

code
[Start]──►[Active]──┐
               ▲    │
               │    ▼
            [Resume] [Pause]
                    │    ▲
                    ▼    │
                 [Paused]

Installation

Add to your Claude Desktop config at `~/Library/Application Support/Claude/claude_desktop_config.json`:

json
{
  "mcpServers": {
    "slowtime": {
      "command": "node",
      "args": ["/path/to/slowtime-mcp-server/build/index.js"]
    }
  }
}

Usage

Basic Interval Commands

code
start_interval "Focus Time" 25  ───► [25min Interval Created]
                                          │
check_interval   ◄───────────────────┘
                                          │
pause_interval   ◄───────────────────┘
                                          │
resume_interval  ◄───────────────────┘

Timelock Encryption

code
1. Start Interval:
   "Focus Time" (25min) ──► [Interval ID: abc123]

2. Encrypt Data:
   "secret" + abc123 ──► [Timelock ID: xyz789]

3. Attempt Decrypt:
   - Before interval ends: "Not yet decryptable"
   - After interval ends: "secret"

Security Features

Timing Attack Prevention

code
Operation ──┬──► Random Delay (100-5000ms)
            │
            ├──► Jittered Timestamps
            │
            └──► Constant-time Comparisons

Timelock Security & Storage

code
┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│   Encrypt   │    │ Distributed │    │  Timelock   │    │  DuckDB     │
│    Data    ├───►│  Randomness ├───►│  Protected  ├───►│  TimeVault  │
│            │    │  Network    │    │    Data     │    │  Storage    │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
                                           │                     ▲
                                           │      ┌──────────────┘
                                           ▼      │
                                    ┌─────────────┴─┐
                                    │   Analytics   │
                                    │ & Statistics  │
                                    └───────────────┘

TimeVault Analytics

code
Query History ──┐
               ├──► ┌─────────────┐
Filter Options ┘    │   DuckDB    │    ┌─────────────┐
                    │   WASM      ├───►│  Analytics  │
Vault Stats ───────►│   Engine    │    │   Results   │
                    └─────────────┘    └─────────────┘

Architecture

The server consists of four main components:

1. TimeFuzz: Provides timing attack protection through:

    2. TimeKeeper: Manages intervals with:

      3. TimeLock: Handles encryption with:

        4. TimeVault: Provides persistent storage and analytics:

          TimeVault Commands

          Query historical data and statistics about encrypted timevaults:

          code
          # List vault history with filtering
          list_vault_history --interval_id=abc123 --decrypted_only=true --limit=10
          
          # Get vault statistics
          get_vault_stats
          
          Example output:
          Total vaults: 150
          Decrypted vaults: 75
          Average decryption time: 45 seconds

          Storage Schema

          The TimeVault uses DuckDB WASM for persistent storage with the following schema:

          sql
          CREATE TABLE timevaults (
            id VARCHAR PRIMARY KEY,
            encrypted_data TEXT NOT NULL,
            round_number BIGINT NOT NULL,
            created_at TIMESTAMP NOT NULL,
            decrypted_at TIMESTAMP,
            interval_id VARCHAR NOT NULL,
            metadata JSON
          );
          
          -- Indexes for efficient querying
          CREATE INDEX idx_interval_id ON timevaults(interval_id);
          CREATE INDEX idx_created_at ON timevaults(created_at);

          Contributing

          1. Fork the repository

          2. Create your feature branch

          3. Commit your changes

          4. Push to the branch

          5. Create a Pull Request

          License

          MIT License - see LICENSE file for details

          Frequently asked questions

          What is slowtime-mcp-server?

          slowtime-mcp-server is A Model Context Protocol server for secure time-based operations with timing attack protection and timelock encryption

          How do I install slowtime-mcp-server?

          Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

          Is slowtime-mcp-server open source?

          Yes — it is hosted on GitHub at https://github.com/bmorphism/slowtime-mcp-server and has 3 stars.

          Related MCP tools

          Run your own MCP server? See who uses it and what to fix.

          Measure it with TrackMCP