███╗ ███╗ ██████╗██████╗ ███████╗██████╗ ██╗ ██╗ ████╗ ████║██╔════╝██╔══██╗██╔════╝██╔══██╗╚██╗ ██╔╝ ██╔████╔██║██║ ██████╔╝███████╗██████╔╝ ╚████╔╝ ██║╚██╔╝██║██║ ██╔═══╝ ╚════██║██╔═══╝ ╚██╔╝ ██║ ╚═╝ ██║╚██████╗██║ ███████║██║ ██║ ╚═╝ ╚═╝ ╚═════╝╚═╝ ╚══════╝╚═╝ ╚═╝

MCPSpy — мониторинг в реальном времени для коммуникации по протоколу контекста модели с использованием eBPF

Обзор

MCPSpy — это мощный инструмент командной строки, использующий технологию eBPF (Extended Berkeley Packet Filter) для мониторинга коммуникации по протоколу Model Context Protocol (MCP) на уровне ядра. Он обеспечивает видимость в реальном времени за сообщениями JSON-RPC 2.0, обмениваемыми между клиентами MCP и серверами, подключаясь к низкоуровневым системным вызовам.

Протокол Model Context поддерживает три транспортных протокола для связи:

• Stdio: Связь по стандартным потокам ввода/вывода
• Потоковый HTTP: прямая HTTP-связь с запросами/ответами с событиями, отправленными сервером
• SSE (события, отправленные сервером): потоковая коммуникация на основе HTTP (устарела)

MCPSpy поддерживает мониторинг как Stdio, так и HTTP/HTTPS транспортов (включая события, отправленные с сервера), обеспечивая полное покрытие каналов связи MCP.

Почему MCPSpy?

MCPSpy - MCP Monitoring with eBPF 🕵️✨

Overview

MCPSpy is a powerful command-line tool that leverages eBPF (Extended Berkeley Packet Filter) technology to monitor Model Context Protocol (MCP) communication at the kernel level. It provides real-time visibility into JSON-RPC 2.0 messages exchanged between MCP clients and servers by hooking into low-level system calls.

The Model Context Protocol supports three transport protocols for communication:

• Stdio: Communication over standard input/output streams
• Streamable HTTP: Direct HTTP request/response communication with server-sent events
• SSE (Server-Sent Events): HTTP-based streaming communication (Deprecated)

MCPSpy supports monitoring of both Stdio and HTTP/HTTPS transports (including Server-Sent Events), providing comprehensive coverage of MCP communication channels.

Why MCPSpy?

The Model Context Protocol is becoming the standard for AI tool integration, but understanding what’s happening under the hood can be challenging. MCPSpy addresses this by providing:

• 🔒 Security Analysis: Monitor what data is being transmitted, detect PII leakage, and audit tool executions
• 🛡️ Prompt Injection Detection: Real-time detection of prompt injection and jailbreak attempts using ML models
• 🐛 Debugging: Troubleshoot MCP integrations by seeing the actual message flow
• 📊 Performance Monitoring: Track message patterns and identify bottlenecks
• 🔍 Compliance: Ensure MCP communications meet regulatory requirements
• 🎓 Learning: Understand how MCP works by observing real communications

Installation

Prerequisites

• Linux kernel version 5.15 or later
• Root privileges (required for eBPF)

Download Pre-built Binary (Auto-detect OS + Arch)

Download the latest release from the release page:

# Set platform-aware binary name
BIN="mcpspy-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed -e 's/x86_64/amd64/' -e 's/aarch64/arm64/')"

# Download the correct binary
wget "https://github.com/alex-ilgayev/mcpspy/releases/latest/download/${BIN}"