Gibber MCP

🚀 Mini Cryptography

This project implements a simple encryption system for secure information transmission between robots.

🚀 Quick Start

The goal of this project is to implement a simple encryption system for secure information transmission between robots. The overall process involves generating public and private keys, deriving a shared secret, encrypting plaintext, and decrypting ciphertext.

✨ Features

• Secure Transmission: Ensures the secure transmission of information between robots.
• Key Generation: Supports the generation of RSA key pairs.
• Shared Secret Derivation: Uses the Diffie - Hellman algorithm to derive a shared secret.
• Encryption and Decryption: Supports AES - 256 - CBC encryption and decryption.

📦 Installation

No specific installation steps are provided in the original document.

💻 Usage Examples

Basic Usage

1. Generate Public and Private Keys

Use the generateKeyPair method to generate an RSA key pair.

const { publicKey, privateKey } = await generateKeyPair();

2. Derive Shared Secret

Use the user's public key and your own private key to derive a shared secret using the Diffie - Hellman algorithm.

const sharedSecret = await deriveSharedSecret({
  userPublicKey: publicKey,
  myPrivateKey: privateKey
});

3. Encrypt Plaintext

Use the derived shared secret to perform AES - 256 - CBC encryption on the plaintext and generate an initialization vector (IV).

const { iv, ct } = await encrypt({
  sharedSecret,
  plaintext: "PAPERCLIP"
});

4. Decrypt Ciphertext

The other party uses the same shared secret, IV, and ciphertext to decrypt and recover the plaintext.

const decryptedText = await decrypt({
  sharedSecret,
  iv,
  ct
});

Example Dialogues

Here are typical dialogue examples between robots:

1. Generate Public and Private Keys

{
  "role": "assistant",
  "content": [
    {
      "type": "tool_use",
      "id": "toolu_0123456789abcdef",
      "name": "generate_key_pair"
    }
  ]
}

2. Derive Shared Secret

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_0123456789abcdef",
      "content": "Shared secret generated: abcdefghijklmnopqrstuvwxyz"
    }
  ]
}

3. Encrypt Plaintext

{
  "role": "assistant",
  "content": [
    {
      "type": "tool_use",
      "id": "toolu_0123456789abcdef",
      "name": "encrypt",
      "input": {
        "sharedSecret": "abcdefghijklmnopqrstuvwxyz",
        "plaintext": "PAPERCLIP"
      }
    }
  ]
}

4. Decrypt Ciphertext

{
  "role": "user",
  // The original document seems incomplete here, but we keep it as it is.
}

📚 Documentation

Task Description

• Goal: Implement a simple encryption system for secure information transmission between robots.
• Tools: Use encryption and decryption functions.
• Operation Process:
  1. First, both parties need to generate public and private keys.
  2. Then, use these keys to derive a shared secret.
  3. Next, encrypt the plaintext with the shared secret.
  4. Finally, the other party decrypts the ciphertext using the shared secret.

Implementation Steps

The implementation steps are the same as the usage examples above.

📄 License

MIT