🍯 Honeypot Transaction Monitoring System

Honeypot MCP サーバー

概要

Honeypot MCP サーバーは、Model Context Protocol（MCP）上に構築された取引インテリジェンスシステムです。脆弱な高齢者を装う AI エージェントが詐欺師にカード情報を提供し、その後、発生した不正取引を監視・分析することで、詐欺師の活動や手法に関する情報を収集できます。

機能

• 13 個の MCP ツール：取引の監視とカード管理に対応する包括的なツールセット
• 取引インテリジェンス：高度な取引検索および分析機能
• カード管理：Lithic API を通じたハニーポットカードの作成と管理
• リアルタイム監視：ライブ取引フィードとアラート購読
• MCP プロトコル：HTTP および Stdio トランスポートによる Model Context Protocol のネイティブサポート

クイックスタート

前提条件

• Node.js 18.0.0+
• Supabase アカウントとデータベース
• Lithic API へのアクセス

インストール

git clone <repository-url>
cd honeypot-mcp-server
npm ci

設定

次の変数を含む .env ファイルを作成します。

# Core Configuration
NODE_ENV=production
PORT=3000

# Database
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_KEY=your_service_key

# Financial API
LITHIC_API_KEY=your_lithic_api_key
LITHIC_ENV=production

# Optional Features
LITHIC_WEBHOOK_SECRET=your_webhook_secret
ENABLE_POLLING=true
POLLING_INTERVAL_MS=5000
MCP_TRANSPORT=http

テスト

# Run test suite
npm test

# Run security tests
npm run test:security

# Run performance tests
npm run test:performance

実行

# Start the server
npm start

# Check health
curl http://localhost:3000/health

MCP ツール

サーバーでは、カテゴリ別に整理された 13 個のツールを提供します。

システム操作（1 個のツール）

• health_check - システムの健全性を監視します

カード管理（5 個のツール）

• list_available_cards - 利用可能なハニーポットカードを一覧表示します
• get_card_details - カードの詳細情報を取得します
• create_honeypot_card - 新しいハニーポットカードを作成します
• update_card_limits - カードの利用限度額を更新します
• toggle_card_state - カードを有効化／無効化します

取引インテリジェンス（5 個のツール）

• get_transaction - 単一の取引の詳細を取得します
• search_transactions - 条件で取引を検索します
• get_recent_transactions - カードの最近の取引を取得します
• get_transactions_by_merchant - 加盟店別に取引を取得します
• get_transaction_details - 取引の包括的な情報を取得します

リアルタイムインテリジェンス（2 個のツール）

• subscribe_to_alerts - 取引アラートを設定します
• get_live_transaction_feed - リアルタイムの取引を監視します

取引インテリジェンス

このシステムは、次のような包括的な取引の監視と分析を提供します。

• 高度な取引検索とフィルタリング
• リアルタイムの取引監視
• 加盟店別の取引分析
• カードベースの取引追跡
• ライブ取引フィード機能

主な用途：監視や調査のワークフローに向けた、効率的な取引インテリジェンスです。

技術スタック

• ランタイム：ES Modules を使用する Node.js
• データベース：Supabase（PostgreSQL）
• 金融 API：Lithic Virtual Card Platform
• プロトコル：Model Context Protocol（MCP）
• テスト：Vitest フレームワーク

API 連携

MCP クライアントの例

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';

const transport = new StdioClientTransport({
  command: 'node',
  args: ['src/mcp-server.js']
});

const client = new Client({
  name: 'fraud-detection-agent',
  version: '1.0.0'
}, {
  capabilities: { tools: {} }
});

await client.connect(transport);
const tools = await client.listTools();

ヘルスチェック

const health = await client.callTool({
  name: 'health_check',
  arguments: { includeDetails: true }
});

開発

プロジェクト構成

src/
├── config/           # Configuration and client setup
├── handlers/         # MCP tool implementations
├── schemas/          # Tool input/output schemas
├── services/         # Business logic services
└── utils/           # Utilities and helpers

tests/
├── unit/            # Unit tests
├── integration/     # Integration tests
├── security/        # Security tests
└── performance/     # Performance tests

テスト

このプロジェクトには、包括的なテストカバレッジが含まれています。

• すべてのハンドラーとサービスを対象とするユニットテスト
• MCP プロトコルへの準拠を確認する統合テスト
• 認証とデータ処理を対象とするセキュリティテスト
• 応答時間を対象とするパフォーマンステスト

デプロイ

詳しいデプロイ手順については、DEPLOYMENT.md を参照してください。

アプリケーションは次の環境にデプロイできます。

• Railway（railway.json が含まれており、推奨）
• Docker コンテナ
• 従来型のサーバー

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細については、LICENSE ファイルを参照してください。