PiQrypt MCPサーバー

Model Context Protocolを介したAIエージェントのための暗号学的監査証跡

Related MCP server: DCL Evaluator

🚀 PiQrypt MCPとは？

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

ユースケース:

• 🤖 AIエージェント: すべての意思決定に暗号学的証明で署名

• 📊 n8nワークフロー: 自動化ワークフローに監査証跡を追加

• 🏦 トレーディングボット: 自動取引のためのSEC/FINRAコンプライアンス

• 👥 人事自動化: 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以上)

1. n8n MCP統合をインストール

2. PiQrypt MCPサーバーを設定に追加

3. MCPノード経由でワークフローで使用

互換性

MCPクライアント

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

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 (文字列, 必須): エージェント識別子

• 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ダッシュボード (オプション, 無料)

スタンプされたすべてのイベントは、PiQryptのローカル監視ダッシュボードであるVigilで確認できます。

注: VigilはMCPサーバーによって自動的に起動されません。 ダッシュボードを開く前に、個別に起動する必要があります。

piqrypt vigil
# → http://localhost:8421

無料プランには、チェーンの健全性、VRSリスクスコア、7日間の履歴、重大なアラートが含まれます。 90日間の履歴、TrustGateガバナンス、耐量子署名についてはProにアップグレードしてください。

🗑️ エージェントの管理

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

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]

人事自動化

[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')"

📖 ドキュメント

• MCPセットアップガイド

• ツールリファレンス

• n8n統合

• セキュリティモデル

• RFCコンプライアンス

🤝 貢献

貢献を歓迎します！CONTRIBUTING.mdを参照してください。

📄 ライセンス

MCPサーバー → MITライセンス - LICENSEを参照 PiQryptコア → 無料プラン + 商用プラン

🔗 リンク

• PiQryptコア: https://github.com/piqrypt/piqrypt

• MCPプロトコル: https://modelcontextprotocol.io

• n8n: https://n8n.io

• ドキュメント: https://docs.piqrypt.com

Built with ❤️ by PiQrypt Inc.