TransactionSimulatorMCP

# MCP Transaction Analyzer A Model Context Protocol (MCP) server that provides AI-powered analysis of Ethereum transactions across any network. This service simulates transactions and generates human-readable interpretations to help users understand potential outcomes before execution. ## Overview The MCP Transaction Analyzer combines blockchain transaction simulation with AI interpretation. - What a transaction will do before they execute it - The potential impact on token balances - Any hidden or unexpected outcomes - Gas usage and cost estimates ## Features - Real-time transaction simulation using Tenderly - AI-powered interpretation using OpenAI or Google's Gemini models - Support for all Ethereum-compatible networks - Detailed analysis of: - ERC20, ERC721, and ERC1155 token transfers - Contract interactions - Balance changes - Gas estimations - Secure HTTPS support in production - Server-Sent Events (SSE) for real-time updates - Full Model Context Protocol integration ## Prerequisites - Node.js >= 18.x - SSL certificates (for production mode) - API keys for: - Tenderly (transaction simulation) - OpenAI and/or Google Gemini (AI interpretation) ## Installation 1. Clone the repository: ```bash git clone [repository-url] cd mcp-transaction-analyzer ``` 2. Install dependencies: ```bash npm install ``` 3. Configure environment variables in `.env`: ```env TENDERLY_ACCOUNT=your_tenderly_account TENDERLY_PROJECT=your_tenderly_project TENDERLY_API_KEY=your_tenderly_api_key OPENAI_API_KEY=your_openai_api_key GEMINI_API_KEY=your_gemini_api_key CERT_PATH=/path/to/ssl/certificates # Required for production ``` ## Usage ### Development Mode ```bash npm run dev ``` ### Production Mode ```bash npm run prod ``` ### Available Scripts - `npm run build` - Compile TypeScript to JavaScript - `npm run dev` - Run development server - `npm run dev:prod` - Run production server with TypeScript - `npm run start` - Start compiled server - `npm run prod` - Run compiled server in production mode - `npm run inspect` - Run MCP inspector on the server ## Usage Add server to Cursor: ```json "mcpServers": { ... "transaction-sim-server": { "url": <URL to your deployed server> } } ``` ### Transaction Simulation The service accepts transaction parameters and returns detailed analysis: ``` { networkId: string, // Network ID for the transaction from: string, // Sender address to: string, // Recipient address value?: string, // ETH value (optional) data?: string, // Transaction data (optional) useEmojis?: boolean // Enable/disable emojis in response } ``` for example, let's take a random transaction from block explorer, type the following into the Cursor chat window, once you have set up your MCP server: ``` Computer, please determine if this transaction is safe: networkId: 8453 from: 0x331F914d9447F0E4BEcAB98d62BEA00dADb8B591 to: 0x24fcFC492C1393274B6bcd568ac9e225BEc93584 data: 0x095ea7b3000000000000000000000000cf77a3ba9a5ca399b7c97c74d54e5b1beb874e43000000000000000000000000000000000000000000002e961634f872dfc30000 ``` ## Dependencies ### Core - `@modelcontextprotocol/sdk`: MCP integration - `ethers`: Ethereum interaction - `@smarttokenlabs/waterfall-rpc`: RPC management ### AI Services - `@anthropic-ai/sdk`: Anthropic AI integration - `@google/generative-ai`: Google Gemini integration - `openai`: OpenAI integration ### Server - `express`: Web server framework - `@fastify/cors`: CORS support ### Development - `typescript`: Type safety - `ts-node`: TypeScript execution - Various type definitions ## Development The project follows TypeScript best practices and is structured around: - `server.ts`: Main MCP server implementation - `processTransaction.ts`: Transaction analysis logic - `tenderly.ts`: Tenderly API integration ## License MIT License ## Author James Brown (j@smarttokenlabs.com) ## Support For issues and feature requests, please create an issue in the repository.