Skip to main content
Glama
@erickwendel/ciphersuite-mcp

@erickwendel/ciphersuite-mcp

by nonatin1000

@erickwendel/ciphersuite-mcp

An MCP (Model Context Protocol) server that provides AES-256-CBC encryption and decryption tools, a resource describing the algorithm, and a ready-to-use prompt β€” all runnable directly inside VS Code Copilot Chat.


What it does

Capability

Name

Description

πŸ”§ Tool

encrypt_message

Encrypts any plain-text message with a passphrase

πŸ”§ Tool

decrypt_message

Decrypts a previously encrypted message with the same passphrase

πŸ“„ Resource

encryption://info

Returns details about the algorithm, key derivation, and output format

πŸ’¬ Prompt

encrypt_message_prompt

Pre-built prompt that asks the agent to encrypt a message

How encryption works

  • Algorithm: AES-256-CBC

  • Key derivation: scrypt(passphrase, fixedSalt, 32) β€” you pass any passphrase string; the server derives a strong 32-byte key automatically

  • Output format: <IV in hex>:<ciphertext in hex> β€” keep the full string to decrypt later

  • IV: a fresh random 16-byte IV is generated on every encryption call, so the same message encrypted twice produces different output


Related MCP server: @erickwendel/ciphersuite-mcp

Prerequisites

  • Python 3.11+

  • uv (recommended) or pip


Installation

uv sync

or with pip:

pip install -e ".[dev]"

Using in VS Code

1. Add the MCP server configuration

Create (or open) .vscode/mcp.json in your workspace and add:

{
  "servers": {
    "ciphersuite-mcp": {
      "command": "uv",
      "args": ["run", "python", "-m", "ciphersuite_mcp"]
    }
  }
}

Tip: You can also add this server to your user-level MCP config at ~/.vscode/mcp.json to make it available in every workspace.

2. Reload VS Code

Open the Command Palette (Cmd+Shift+P) and run Developer: Reload Window (or just restart VS Code).

3. Use it in Copilot Chat

Open Copilot Chat (Agent mode) and try:

Encrypt the message "Hello, World!" using the passphrase "my-secret-key"
Decrypt this message: a3f1...:<ciphertext> using the passphrase "my-secret-key"
Show me the encryption://info resource

The agent will automatically call the appropriate tool and return the result.


Running the MCP Inspector

The MCP Inspector lets you explore and test all tools, resources, and prompts interactively in a browser UI:

npx @modelcontextprotocol/inspector uv run python -m ciphersuite_mcp

This opens the inspector at http://localhost:5173 and connects it to the running server.


Running tests

uv run pytest

The test suite covers:

  • Encrypting a message

  • Decrypting a message with the correct passphrase

  • Error: decrypting with the wrong passphrase

  • Listing the encryption://info resource

  • Fetching the encrypt_message_prompt


Project structure

src/ciphersuite_mcp/
  __init__.py
  __main__.py   # Entry point β€” connects the server to stdio transport
  server.py     # All tools, resources, and prompts are registered here
  service.py    # AES-256-CBC encryption/decryption logic
tests/
  conftest.py   # Shared MCP client fixture
  test_mcp.py

Available commands

Command

Description

uv run python -m ciphersuite_mcp

Start the server (used by MCP clients)

uv run pytest

Run all tests

uv run pytest -k <expr>

Run a subset of tests

npx @modelcontextprotocol/inspector uv run python -m ciphersuite_mcp

Open the MCP Inspector UI

Available Tools

2 tools
decrypt_messageB

Decrypt a message that was encrypted with the encrypt_message tool

Inputs: encryption_key (required), encrypted_message (required). Returns: decryptedMessage

encrypt_messageC

Encrypt a message

Inputs: message (required), encryption_key (required). Returns: encryptedMessage

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have mutually exclusive and clearly defined purposes: one encrypts, the other decrypts. There is no possible confusion between them, as the operations are exact inverses and each description explicitly points to the other.

    Naming Consistency5/5

    Both tool names follow a consistent verb_noun pattern (encrypt_message, decrypt_message). The naming is predictable and symmetrical, making the intent immediately obvious without needing to read descriptions.

    Tool Count3/5

    With only two tools, the server covers a narrow but coherent feature set. While this is on the low end, it is not unreasonable for a dedicated cipher suite that aims to provide basic symmetric encryption and decryption. The count is thin, but not absurdly so for the stated scope.

    Completeness3/5

    The tool surface covers the fundamental encrypt/decrypt cycle, but lacks other expected operations in a cipher suite, such as key generation, rotation, or support for additional algorithms. For a simple utility, this might be sufficient, but it leaves notable gaps for real-world use cases.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI agents to perform symmetric and asymmetric encryption of text and files using secure storage in the macOS Keychain. It provides tools for identity management and secure messaging compatible with the CryptoSeed iOS app and CLI.
      -
    • A
      license
      A
      quality
      D
      maintenance
      Provides AES-256-CBC encryption and decryption tools, a resource for algorithm details, and prompts for encrypting and decrypting messages, all runnable inside VS Code Copilot Chat.
      2
      ISC
    • A
      license
      A
      quality
      D
      maintenance
      Enables AES-256-CBC encryption and decryption of messages with passphrase-derived keys, exposing tools, resources, and prompts for MCP clients like VS Code Copilot Chat.
      2
      ISC
    • A
      license
      C
      quality
      C
      maintenance
      Provides AES-256-CBC encryption and decryption tools, an algorithm info resource, and ready-to-use prompts for use in MCP-compatible clients like VS Code Copilot Chat.
      1
      ISC