ciphersuite-mcp

Сервер MCP (Model Context Protocol), предоставляющий инструменты шифрования и дешифрования AES-256-CBC, ресурсы с описанием каждого алгоритма и готовые промпты — всё это можно запускать прямо внутри VS Code Copilot Chat.

Related MCP server: Secret Vault MCP Server

Что он делает

Как работает шифрование

• Алгоритм: AES-256-CBC

• Выработка ключа: scrypt(passphrase, fixedSalt, 32) — вы передаёте любую строку в качестве парольной фразы; сервер автоматически вырабатывает надёжный 32-байтовый ключ

• Формат вывода: <IV in hex>:<ciphertext in hex> — сохраните всю строку целиком, чтобы позже расшифровать сообщение

• IV: при каждом вызове шифрования генерируется новый случайный 16-байтовый IV, поэтому одно и то же сообщение, зашифрованное дважды, даёт разный результат

Предварительные требования

• Node.js v24+ (см. engines в package.json)

Установка

npm install

Шаг сборки не требуется — сервер запускает TypeScript напрямую через встроенную поддержку TypeScript в Node.js.

Использование в VS Code

1. Добавьте конфигурацию MCP-сервера

Создайте (или откройте) .vscode/mcp.json в рабочей области и добавьте:

{
  "servers": {
    "ciphersuite-mcp": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

или через npm:

{
  "servers": {
    "ciphersuite-mcp": {
      "command": "npx",
      "args": ["-y", "@igorromero/ciphersuite-mcp"]
    }
  }
}

Совет: Вы также можете добавить этот сервер в пользовательскую конфигурацию MCP в ~/.vscode/mcp.json, чтобы он был доступен в любой рабочей области.

2. Перезагрузите VS Code

Откройте палитру команд (Cmd+Shift+P) и выполните Developer: Reload Window (или просто перезапустите VS Code).

3. Используйте в Copilot Chat

Откройте Copilot Chat (режим Agent) и попробуйте:

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

Агент автоматически вызовет нужный инструмент и вернёт результат.

Запуск MCP Inspector

MCP Inspector позволяет в интерактивном режиме исследовать и тестировать все инструменты, ресурсы и промпты в браузерном интерфейсе:

npm run mcp:inspect

Это откроет MCP Inspector на http://localhost:5173 и подключит его к запущенному серверу.

Запуск тестов

# Run all tests once
npm test

# Run tests in watch mode (with debugger)
npm run test:dev

Тестовый набор покрывает:

• Шифрование сообщения

• Расшифровка сообщения с правильной парольной фразой

• Получение списка и чтение ресурса encryption://info

• Получение обоих промптов

• Ошибка: расшифровка с неверной парольной фразой

• Ошибка: расшифровка некорректного шифротекста

Структура проекта

src/
  index.ts   # Entry point — connects the server to stdio transport
  mcp.ts     # All tools, resources, and prompts are registered here
tests/
  mcp.test.ts

Доступные скрипты

Создание с нуля

В этом разделе описано, как этот MCP-сервер создавался шаг за шагом — полезно для создания новых MCP-серверов в будущем.

Типы транспорта MCP

Существует 3 типа транспорта MCP:

Зависимости

// package.json
"dependencies": {
  "@modelcontextprotocol/sdk": "^1.27.1",
  "@types/node": "^24.11.0",
  "zod": "^3.25.76"
}

1. Точка входа — src/index.ts

Точка входа создаёт StdioServerTransport и подключает к нему MCP-сервер:

// src/index.ts
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { server } from "./mcp.ts";

async function main() {
    const transport = new StdioServerTransport()
    await server.connect(transport)
    console.error('Encrypt MCP Server running on stdio')
}

main().catch((error) => {
    console.error("Fatal error in main():", error);
    process.exit(1);
});

2. Настройка сервера — src/mcp.ts

Создайте экземпляр MCP-сервера с именем и версией:

// src/mcp.ts
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

export const server = new McpServer({
    name: '@igorromero/ciphersuite-mcp',
    version: '0.0.1'
})

3. Регистрация инструментов

Инструменты — это функции, которые LLM может вызывать для выполнения действий. Используйте server.registerTool, который принимает 3 аргумента:

1. Название инструмента (строка)

2. Объект конфигурации, содержащий:

   • description — описание того, что делает инструмент; LLM использует его, чтобы решить, когда его вызывать

   • inputSchema — аналог тела запроса, определяется с помощью Zod

   • outputSchema — аналог тела ответа, определяется с помощью Zod

3. Асинхронная функция-обработчик — собственно реализация

server.registerTool(
    'encrypt_message',
    {
        description: 'Encrypt a message',
        inputSchema: {
            message: z.string().describe("The message to encrypt"),
            encryptionKey: z.string().describe(
                "Any passphrase to use for encryption — the server derives a strong key from it automatically"
            )
        },
        outputSchema: {
            encryptedMessage: z.string().describe(
                "The encrypted message (format: iv:ciphertext)"
            )
        }
    },
    async ({ message, encryptionKey }) => {
        try {
            const encryptedMessage = encrypt(message, encryptionKey)
            return {
                content: [{ type: "text", text: encryptedMessage }],
                structuredContent: { encryptedMessage }
            }
        } catch (error) {
            return {
                isError: true,
                content: [{
                    type: 'text',
                    text: `Failed to encrypt message! Error: ${error instanceof Error ? error.message : String(error)}`
                }]
            }
        }
    }
)

Тот же принцип применяется к decrypt_message — просто поменяйте местами поля схемы ввода/вывода и вызовите decrypt().

4. Регистрация ресурсов

Ресурсы предоставляют статическую или вычисляемую информацию, которая помогает LLM понять контекст вокруг инструмента. Используйте server.registerResource, который принимает 4 аргумента:

1. Название ресурса

2. Шаблон URI (обычно совпадает с названием)

3. Объект конфигурации, содержащий description

4. Функция-обработчик, возвращающая contents — массив объектов с полями uri, mimeType и text

server.registerResource(
    'encryption://info',
    'encryption://info',
    {
        description: 'Describes the encryption algorithm, key requirements, and output format used by this server',
    },
    () => ({
        contents: [
            {
                uri: "encryption://info",
                mimeType: "text/plain",
                text: `
Algorithm : AES-256-CBC
Key derivation: scrypt (passphrase + fixed server salt → 32-byte key)
Output format: <16-byte IV in hex>:<ciphertext in hex>  (separated by ":")
Notes:
  - Users pass any passphrase — the server derives a strong 32-byte key automatically using scrypt.
  - A random IV is generated for every encryption — the same message encrypted twice will produce different output.
  - Use the exact same passphrase to decrypt.
  - Keep the full "iv:ciphertext" string to decrypt later.
                `.trim(),
            },
        ]
    })
)

Ресурс decryption://info устроен так же и описывает ожидаемый формат входных данных, требования к парольной фразе и типичные сценарии ошибок для инструмента дешифрования.

5. Регистрация промптов

Промпты — это готовые шаблоны сообщений, которые LLM может использовать для направленного вызова инструментов. Используйте server.registerPrompt, который принимает 3 аргумента:

1. Название промпта

2. Объект конфигурации, содержащий:

   • description — описание того, что делает промпт

   • argsSchema — входные параметры, определяемые с помощью Zod

3. Функция-обработчик, возвращающая messages — массив объектов с полями role (user или assistant) и content

server.registerPrompt(
    "encrypt_message_prompt",
    {
        description: "Prompt to encrypt a plain-text message using the encrypt_message tool",
        argsSchema: {
            message: z.string().describe("The message to encrypt"),
            encryptionKey: z.string().describe(
                "Any passphrase to use for encryption — the server derives a strong key from it automatically"
            )
        }
    },
    ({ message, encryptionKey }) => ({
        messages: [
            {
                role: 'user',
                content: {
                    type: "text",
                    text: `Please encrypt the following message using the encrypt_message tool.\nMessage: ${message}\nEncryption key: ${encryptionKey}`,
                }
            }
        ]
    })
)

Промпт decrypt_message_prompt устроен так же — принимает encryptedMessage и encryptionKey в качестве аргументов и предписывает LLM вызвать decrypt_message.

6. Подключение MCP-сервера к IDE

VS Code (автоматически)

Создайте .vscode/mcp.json в корне проекта. VS Code обнаружит его автоматически:

{
    "servers": {
        "ciphersuite-mcp": {
            "command": "node",
            "args": [
                "--experimental-strip-types",
                "src/index.ts"
            ]
        }
    }
}

Другие IDE / Другие проекты

Скопируйте запись сервера ciphersuite-mcp в файл конфигурации MCP целевого проекта или IDE. Сервер запускается как подпроцесс через stdio, поэтому к нему может подключиться любой MCP-совместимый клиент.