🍯 Honeypot Transaction Monitoring System

蜜罐 MCP 服务

概述

蜜罐 MCP 服务是一个基于模型上下文协议（MCP）构建的交易情报系统。它使扮演易受骗老年人角色的 AI Agent 能够向诈骗者提供卡片信息，随后监控和分析由此产生的欺诈交易，以收集有关诈骗者运作方式和手段的情报。

功能

• 13 个 MCP 工具：用于交易监控和卡片管理的全面工具集
• 交易情报：高级交易搜索和分析能力
• 卡片管理：通过 Lithic API 创建和管理蜜罐卡片
• 实时监控：实时交易动态和警报订阅
• MCP 协议：原生支持采用 HTTP 和 Stdio 传输方式的模型上下文协议

快速开始

前提条件

• 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 虚拟卡平台
• 协议：模型上下文协议（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 文件。