PiQrypt MCP Server

Криптографический журнал аудита для ИИ-агентов через протокол Model Context Protocol

Related MCP server: DCL Evaluator

🚀 Что такое PiQrypt MCP?

PiQrypt MCP Server предоставляет доступ по протоколу Model Context Protocol к PiQrypt — постквантовому криптографическому журналу аудита для ИИ-агентов.

Варианты использования:

• 🤖 ИИ-агенты: подпись каждого решения криптографическим доказательством

• 📊 Рабочие процессы n8n: добавление журнала аудита в процессы автоматизации

• 🏦 Торговые боты: соответствие требованиям SEC/FINRA для автоматизированной торговли

• 👥 HR-автоматизация: принятие решений о найме с помощью ИИ в соответствии с GDPR

• 🏥 ИИ в здравоохранении: журнал аудита HIPAA для медицинских решений

📦 Установка

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

1. Установите piqrypt (обязательно — Python 3.8+)

pip install piqrypt

MCP-сервер делегирует все криптографические операции Python-пакету piqrypt. Если он не установлен, сервер будет возвращать понятную ошибку при каждом вызове инструмента.

2. Установите MCP-сервер (Node.js 18+)

npm install -g @piqrypt/mcp-server

Установка через npx (без глобальной установки)

npx @piqrypt/mcp-server

Сборка из исходного кода

git clone https://github.com/piqrypt/piqrypt-mcp-server
cd piqrypt-mcp-server
npm install
npm run build

PIQRYPT_PYTHON — пользовательское окружение Python

По умолчанию сервер использует python3 (Linux/Mac) или python (Windows). Если piqrypt установлен в виртуальном окружении, установите эту переменную, чтобы указать путь к нужному интерпретатору:

Windows

set PIQRYPT_PYTHON=C:\path\to\venv\Scripts\python.exe

Linux / Mac

export PIQRYPT_PYTHON=/path/to/venv/bin/python

Чтобы сделать настройку постоянной, добавьте её в конфигурацию вашего MCP-клиента:

{
  "mcpServers": {
    "piqrypt": {
      "command": "piqrypt-mcp-server",
      "args": [],
      "env": {
        "PIQRYPT_PYTHON": "/path/to/venv/bin/python"
      }
    }
  }
}

⚙️ Конфигурация

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "piqrypt": {
      "command": "piqrypt-mcp-server",
      "args": []
    }
  }
}

n8n (v1.88+)

1. Установите интеграцию n8n MCP

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

3. Используйте в рабочих процессах через узел MCP

Совместимость

MCP-клиенты

Платформы автоматизации (через узел MCP)

Что можно проверять с помощью PiQrypt MCP

Каждый вызов инструмента проходит через 4 операции — фиксация (stamp), проверка (verify), экспорт (export), поиск (search). Вот что это означает на практике в зависимости от вашего контекста:

Автоматизированная торговля / финансы Любой агент, который отправляет ордера, ребалансирует портфели или инициирует транзакции, может зафиксировать каждое решение перед исполнением. Подписанная цепочка может быть экспортирована для аудита SEC/FINRA без дополнительной инфраструктуры.

HR и автоматизация найма Любой рабочий процесс, который оценивает кандидатов, выставляет баллы за резюме или распределяет соискателей, может зафиксировать каждое решение. Обеспечивает журнал аудита, соответствующий ст. 22 GDPR для найма с помощью ИИ — кто решил что, когда и какие данные использовались (хешированные, никогда не хранятся в сыром виде).

Контент и издательские процессы Любой агент, который составляет черновики, одобряет или публикует контент, может зафиксировать каждый шаг. Полезно, когда несколько ИИ-агентов сотрудничают, и вам нужно доказать авторство — какой агент что написал и в каком порядке.

DevOps и CI/CD Любой агент, который инициирует развертывание, объединяет ветки или меняет секреты, может зафиксировать каждое действие. Обеспечивает защищенную от несанкционированного доступа запись об изменениях инфраструктуры, сделанных автономными агентами.

Здравоохранение и медицинский ИИ Любой диагностический или сортировочный агент может зафиксировать каждую рекомендацию. Обеспечивает журнал аудита, соответствующий HIPAA, связывающий каждый результат ИИ с проверяемой личностью агента.

Общий шаблон во всех случаях:

[Agent makes decision]
↓
piqrypt_stamp_event    ← sign + chain
↓
[Agent executes action]
↓
piqrypt_export_audit   ← portable proof, verifiable
                          without PiQrypt installed

🛠️ Доступные инструменты

1. piqrypt_stamp_event

Подписать решение ИИ криптографическим доказательством.

Параметры:

• agent_id (строка, обязательно): Идентификатор агента

• payload (объект, обязательно): Данные решения

• previous_hash (строка, опционально): Хеш предыдущего события для создания цепочки

Пример:

const event = await mcp.call('piqrypt_stamp_event', {
  agent_id: 'trading_bot_v1',
  payload: {
    action: 'buy',
    symbol: 'AAPL',
    quantity: 100,
    price: 150.25
  }
});

Возвращает:

{
  "version": "AISS-1.0",
  "agent_id": "trading_bot_v1",
  "timestamp": 1739382400,
  "nonce": "uuid-...",
  "payload": { ... },
  "previous_hash": "sha256:...",
  "signature": "base64:..."
}

2. piqrypt_verify_chain

Проверить целостность цепочки событий.

Параметры:

• events (массив, обязательно): События для проверки

Пример:

const result = await mcp.call('piqrypt_verify_chain', {
  events: [event1, event2, event3]
});

Возвращает:

{
  "valid": true,
  "events_count": 3,
  "chain_hash": "sha256:...",
  "errors": []
}

3. piqrypt_export_audit

Экспортировать журнал аудита для соответствия требованиям.

Параметры:

• agent_id (строка, обязательно): Агент для экспорта

• certified (логическое): Запросить сертификацию PiQrypt

• output_format (строка): json или pqz

Пример:

const audit = await mcp.call('piqrypt_export_audit', {
  agent_id: 'trading_bot_v1',
  certified: true,
  output_format: 'json'
});

4. piqrypt_search_events

Быстрый поиск через индекс SQLite.

Параметры:

• event_type (строка, опционально): Фильтр по типу

• from_timestamp (число, опционально): Время начала

• to_timestamp (число, опционально): Время окончания

• limit (число): Макс. количество результатов (по умолчанию: 100)

Пример:

const trades = await mcp.call('piqrypt_search_events', {
  event_type: 'trade_executed',
  from_timestamp: 1739300000,
  limit: 50
});

📊 Панель мониторинга Vigil (опционально, бесплатно)

Каждое зафиксированное событие отображается в Vigil — локальной панели мониторинга PiQrypt.

Примечание: Vigil не запускается автоматически MCP-сервером. Вы должны запустить его отдельно перед открытием панели.

piqrypt vigil
# → http://localhost:8421

Бесплатный уровень включает: состояние цепочки, показатель риска VRS, историю за 7 дней, КРИТИЧЕСКИЕ оповещения. Перейдите на Pro для получения истории за 90 дней, управления TrustGate и постквантовых подписей.

🗑️ Управление агентами

Агенты создаются автоматически при первой фиксации. Чтобы просмотреть и удалить агентов:

1. Запустите Vigil: piqrypt vigil

2. Откройте http://localhost:8421

3. Перейдите в представление All Agents

4. Отметьте агентов для удаления → нажмите ✕ Delete selected

5. Подтвердите — Vigil вернется на экран приветствия, когда агентов не останется

Агенты хранятся в ~/.piqrypt/agents/ на вашем компьютере. Удаление агента навсегда удаляет его ключи и историю событий.

🔒 Модель безопасности

Изоляция процессов

┌─────────────────────────────────────┐
│  MCP Client (any MCP-compatible client)     │
│  ↓ JSON-RPC over stdio              │
├─────────────────────────────────────┤
│  MCP Server (TypeScript/Node.js)    │  ← No crypto here
│  ↓ subprocess call                  │
├─────────────────────────────────────┤
│  Python Bridge (bridge.py)          │
│  ↓ invokes CLI                      │
├─────────────────────────────────────┤
│  PiQrypt CLI (Python)               │
│  ↓ uses                             │
├─────────────────────────────────────┤
│  Core Crypto (aiss package)         │  ← All crypto here
│  • Ed25519 / Dilithium3             │
│  • RFC 8785 canonical JSON          │
│  • Hash chains                      │
└─────────────────────────────────────┘

Гарантии

✅ Приватные ключи никогда не передаются на уровень MCP ✅ Вся криптография на Python (Ed25519, Dilithium3) ✅ Такая же безопасность, как у CLI (изоляция процессов) ✅ Соответствие RFC AISS-1.1 (идентичный вывод) ✅ Валидация входных данных перед вызовом подпроцесса

📚 Примеры

Торговый бот (n8n)

[Webhook: price alert] 
    ↓
[AI Decision: buy/sell?]
    ↓
[PiQrypt MCP: stamp decision]  ← Audit trail
    ↓
[Execute trade API]
    ↓
[Database: store proof]

HR-автоматизация

[Upload CV]
    ↓
[AI Agent: evaluate candidate]
    ↓
[PiQrypt MCP: stamp evaluation]  ← GDPR compliance
    ↓
[Email HR team]

🧪 Тестирование

# Build
npm run build

# Test bridge
python3 src/python/bridge.py stamp '{"agent_id":"test","payload":{"action":"test"}}'

# Test MCP server (manual)
node dist/index.js
# Then send MCP request via stdin

🔧 Устранение неполадок

Error: piqrypt is not installed in this Python environment

Интерпретатор Python, используемый MCP-сервером, не может найти пакет piqrypt.

Решение:

pip install piqrypt

Если piqrypt установлен в виртуальном окружении, а не в системном Python, установите PIQRYPT_PYTHON для указания правильного интерпретатора:

# Linux / Mac
export PIQRYPT_PYTHON=/path/to/venv/bin/python

# Windows
set PIQRYPT_PYTHON=C:\path\to\venv\Scripts\python.exe

Чтобы проверить, какой Python будет использовать сервер:

# Linux / Mac
$PIQRYPT_PYTHON -c "import aiss; print('ok')"

# Windows
%PIQRYPT_PYTHON% -c "import aiss; print('ok')"

📖 Документация

• Руководство по настройке MCP

• Справочник инструментов

• Интеграция с n8n

• Модель безопасности

• Соответствие RFC

🤝 Участие в разработке

Мы приветствуем вклад! См. CONTRIBUTING.md.

📄 Лицензия

MCP Server → Лицензия MIT - см. LICENSE PiQrypt Core → бесплатный уровень + коммерческие уровни

🔗 Ссылки

• PiQrypt Core: https://github.com/piqrypt/piqrypt

• Протокол MCP: https://modelcontextprotocol.io

• n8n: https://n8n.io

• Документация: https://docs.piqrypt.com

Создано с ❤️ компанией PiQrypt Inc.