Bmorphism Slowtime MCP Server

🚀 Slowtime MCP Server

A Model Context Protocol server for secure time operations, featuring timing attack protection and time-lock encryption.

🚀 Quick Start

The Slowtime MCP Server is a powerful tool designed for secure time operations. It provides protection against timing attacks and supports time-lock encryption. The following is a high - level overview of its architecture:

                                     ┌──────────────┐
                                     │   Claude     │
                                     │   Desktop    │
                                     └──────┬───────┘
                                            │
                                            ▼
┌──────────────┐                    ┌──────────────┐
│   Time - Lock│◄──────────────────►│   Slowtime   │
│  Encryption  │                    │     MCP      │
└──────────────┘                    │    Server    │
                                    └──────┬───────┘
                                           │
                                           ▼
┌──────────────┐                   ┌──────────────┐
│    Timing    │◄─────────────────►│  Interval    │
│  Attack       │                   │   Manager    │
│ Protection   │                   └──────────────┘
└──────────────┘

✨ Features

• Time Obfuscation: Provides protection against timing attacks through random duration jitter, constant - time comparison, jittered timestamps, and random operation delays.
• Time Guardian: Manages intervals, including create/pause/resume operations, progress tracking, automatic cleanup, and obfuscation integration.
• Time Lock: Handles encryption, including drand network integration, interval - based decryption, automatic cleanup, and secure random number generation.
• Time Vault: Offers persistent storage and analysis, including WASM - based DuckDB storage, historical encrypted data tracking, analysis results, and query capabilities.

📦 Installation

1. Fork the repository.
2. Create your feature branch.
3. Commit your changes.
4. Push to the branch.
5. Create a pull request.

💻 Usage Examples

Basic Usage

Create an interval:

create_interval --name=my_interval --duration=60s

Pause an interval:

pause_interval --id=123

Resume an interval:

resume_interval --id=123

List all intervals:

list_intervals

Delete an interval:

delete_interval --id=123

Advanced Usage

Time - Lock Encryption

Generate a time - lock key:

generate_timelock_key --interval_id=123 --output=key.txt

Encrypt data:

encrypt_data --key=key.txt --data=data.bin --output=ciphertext.bin

Decrypt data:

decrypt_data --ciphertext=ciphertext.bin --output=data.bin

🔧 Technical Details

Security Features

• Time Obfuscation: Protects against timing attacks through random duration jitter, constant - time comparison, and jittered timestamps.
• Time Guardian: Manages interval operations, including creation, pausing, and resuming, and tracks progress.
• Time Lock: Integrates with the drand network for encryption, supports interval - based decryption, and generates secure random numbers.

Architecture

The server consists of four main components:

1. Time Obfuscation: Provides protection against timing attacks:

   • Random duration jitter
   • Constant - time comparison
   • Jittered timestamps
   • Random operation delays

2. Time Guardian: Manages intervals:

   • Create/pause/resume operations
   • Progress tracking
   • Automatic cleanup
   • Obfuscation integration

3. Time Lock: Handles encryption:

   • Drand network integration
   • Interval - based decryption
   • Automatic cleanup
   • Secure random number generation

4. Time Vault: Offers persistent storage and analysis:

   • WASM - based DuckDB storage
   • Encrypted data history tracking
   • Analysis results and statistics
   • Query capabilities

Time Vault Commands

Query the history and statistics of the encrypted vault:

# List the vault history for a specified interval ID, showing only decrypted entries, limited to the top 10
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 Scheme

The Time Vault uses DuckDB WASM for persistent storage. The storage schema is as follows:

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 to improve query efficiency
CREATE INDEX idx_interval_id ON timevaults(interval_id);
CREATE INDEX idx_created_at ON timevaults(created_at);

🤝 Contribution

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 the LICENSE file for details.