Piqrypt Mcp Server

Name: Piqrypt Mcp Server
Author: PiQrypt

ローカル

github.com/PiQryptセキュリティ025 週間前に更新

リポジトリ

Piqrypt Mcp Server について

PiQrypt MCP Serverは、AIエージェントや自動化ワークフローで意思決定イベントを記録・検証するため、PiQryptの暗号監査機能を提供します。署名とハッシュチェーンにより、検索・エクスポート可能な監査記録を作成します。

主な機能

01意思決定イベントへの署名とハッシュ連結
02イベントチェーンの整合性検証
03監査記録のエクスポート
04種別と時刻によるイベント検索
05SQLiteインデックスを使った検索

活用シーン

01自動取引の意思決定をコンプライアンス監査用に記録
02人事・医療AIの意思決定プロセスを追跡
03エージェントが実行したデプロイやインフラ操作を監査

MCP 対応

互換性のあるMCPクライアントに、イベント署名、チェーン検証、監査エクスポート、イベント検索のツールを公開します。暗号処理はPythonの`piqrypt`パッケージに委ねます。

#security #compliance #audit-trail #cryptography #ai-agents #post-quantum #ed25519 #gdpr #hipaa #mcp

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "piqrypt": {
      "command": "npx",
      "args": [
        "-y",
        "@piqrypt/mcp-server"
      ]
    }
  }
}

起動コマンドnpx -y @piqrypt/mcp-server

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@piqrypt/mcp-server1.5.2stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
payload	object	はい	意思決定データを含むイベントペイロード（JSON オブジェクト）
agent_id	string	はい	エージェント識別子（例："trading_bot_v1"、"hr_decision_engine"）
previous_hash	string	いいえ	チェーンの整合性を保つための、前のイベントの任意のハッシュ

詳細

PiQrypt MCP Server

Model Context Protocol を介した AI エージェント向け暗号監査証跡

🚀 PiQrypt MCP とは？

PiQrypt MCP Server は、AI エージェント向けの耐量子暗号監査証跡である PiQrypt への Model Context Protocol アクセスを提供します。

用途：

🤖 AI エージェント：あらゆる判断に暗号学的証明を付与
📊 n8n ワークフロー：自動化ワークフローに監査証跡を追加
🏦 トレーディングボット：自動取引における SEC／FINRA コンプライアンス
👥 HR 自動化：GDPR に準拠した AI 採用判断
🏥 医療 AI：医療上の判断に関する HIPAA 監査証跡

📦 インストール

前提条件

1. piqrypt をインストールします（必須 — Python 3.8+）

pip install piqrypt

MCP サーバーは、すべての暗号処理を piqrypt Python パッケージに委譲します。インストールされていない場合、ツールを呼び出すたびに明確なエラーが返されます。

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+）

n8n MCP 統合をインストールします
PiQrypt MCP サーバーを設定に追加します
MCP ノード経由でワークフローに使用します

対応環境

MCP クライアント

クライアント	バージョン	備考
MCP 互換クライアント全般	MCP spec 2024-11+	stdio トランスポート
n8n	1.88+	MCP ノード経由
Cursor	any	MCP 設定に追加
VS Code	any	MCP 設定に追加
Continue	any	MCP 設定に追加
Windsurf	any	MCP 設定に追加

自動化プラットフォーム（MCP ノード経由）

プラットフォーム	統合方法	用途
n8n	MCP ノード（ネイティブ）	ノーコードの監査証跡
Make.com	HTTP モジュール	Webhook によるスタンプ付与
Zapier	Webhooks + HTTP	基本的なイベント記録

PiQrypt MCP で監査できること

すべてのツール呼び出しは、同じ 4 つの操作を経由します — スタンプ、検証、エクスポート、検索です。各コンテキストで実際にどのように役立つかを説明します。

自動取引／金融 注文の発注、ポートフォリオのリバランス、または取引の実行を行うエージェントは、実行前に各判断にスタンプを付けられます。署名済みのチェーンは、追加のインフラストラクチャなしで SEC/FINRA 監査用にエクスポートできます。

人事および採用の自動化 候補者の評価、履歴書の採点、または応募者の振り分けを行うワークフローは、各判断にスタンプを付けられます。AI を活用した採用について、GDPR 第 22 条に準拠した監査証跡を提供します。誰が、いつ、何を判断し、どのデータを使用したかを確認できます（ハッシュ化され、生データは保存されません）。

コンテンツおよび公開のパイプライン コンテンツの草案作成、承認、または公開を行うエージェントは、各ステップにスタンプを付けられます。複数の AI エージェントが協力し、どのエージェントが何を、どの順序で作成したかという帰属を証明する必要がある場合に役立ちます。

DevOps および CI/CD デプロイの実行、ブランチのマージ、またはシークレットのローテーションを行うエージェントは、各アクションにスタンプを付けられます。自律型エージェントによるインフラストラクチャの変更について、改ざんを検知できる記録を提供します。

ヘルスケアおよび医療 AI 診断またはトリアージを行うエージェントは、推奨内容にスタンプを付けられます。各 AI 出力を検証可能なエージェント ID に結び付ける、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`

暗号学的証明を付けて AI の判断に署名します。

パラメーター：

agent_id （string、必須）：エージェント識別子
payload （object、必須）：判断データ
previous_hash （string、任意）：チェーン化に使用する前のイベントのハッシュ

例：

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 （array、必須）：検証するイベント

例：

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 （string、必須）：エクスポートするエージェント
certified （boolean）：PiQrypt による認証をリクエストします
output_format （string）：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 （string、任意）：タイプで絞り込みます
from_timestamp （number、任意）：開始時刻
to_timestamp （number、任意）：終了時刻
limit （number）：最大結果数（デフォルト：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 日間の履歴、CRITICAL アラートが含まれます。 90 日間の履歴、TrustGate ガバナンス、ポスト量子署名を利用するには、Pro にアップグレードしてください。

🗑️ エージェントの管理

エージェントは、最初のスタンプ時に自動的に作成されます。エージェントを表示および削除するには：

Vigil を起動します：piqrypt vigil
http://localhost:8421 を開きます
すべてのエージェントビューに移動します
削除するエージェントにチェックを入れ、✕ 選択項目を削除をクリックします
確認します。エージェントが残っていない場合、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]

人事の自動化

[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`

MCP サーバーが使用する Python インタープリターで、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')"

📖 ドキュメント

🤝 コントリビューション

コントリビューションを歓迎します！CONTRIBUTING.md をご覧ください。

📄 ライセンス

MCP Server → MIT ライセンス - LICENSE をご覧ください PiQrypt Core → 無料プラン + 商用プラン

🔗 リンク

PiQrypt Core: https://github.com/piqrypt/piqrypt
MCP Protocol: https://modelcontextprotocol.io
n8n: https://n8n.io
ドキュメント: https://docs.piqrypt.com

PiQrypt Inc. が ❤️ を込めて開発

Markdown 対応

ログインしてコメント

基本情報

作者: PiQrypt
言語: node
バージョン: 1.5.2
トランスポート: stdio
掲載日: 2026年4月18日
最終更新: 25 週間前
公式 Registry: io.github.PiQrypt/audit-trail

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

Piqrypt Mcp Server

Piqrypt Mcp Server について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

PiQrypt MCP Server

🚀 PiQrypt MCP とは？

📦 インストール

前提条件

npx でインストール（グローバルインストール不要）

ソースからビルド

PIQRYPT_PYTHON — カスタム Python 環境

⚙️ 設定

Claude Desktop

n8n（v1.88+）

対応環境

MCP クライアント

自動化プラットフォーム（MCP ノード経由）

PiQrypt MCP で監査できること

🛠️ 利用可能なツール

1. piqrypt_stamp_event

2. piqrypt_verify_chain

3. piqrypt_export_audit

4. piqrypt_search_events

📊 Vigil ダッシュボード（オプション、無料）

🗑️ エージェントの管理

🔒 セキュリティモデル

プロセス分離

保証事項

📚 例

取引ボット（n8n）

人事の自動化

🧪 テスト

🔧 トラブルシューティング

Error: piqrypt is not installed in this Python environment

📖 ドキュメント

🤝 コントリビューション

📄 ライセンス

🔗 リンク

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？

1. `piqrypt_stamp_event`

2. `piqrypt_verify_chain`

3. `piqrypt_export_audit`

4. `piqrypt_search_events`

`Error: piqrypt is not installed in this Python environment`