Universal IDE Support

Works with Any IDE

MCP Shark is compatible with all IDEs that support the Model Context Protocol

Whether you use Cursor, Windsurf, Claude Code, or any other MCP-compatible IDE, MCP Shark seamlessly integrates to capture and analyze your MCP traffic. Includes an integrated MCP playground for safe testing and exploration.

Cursor

AI-powered code editor

Fully Supported

Windsurf

AI-native IDE

Fully Supported

Claude Code

Anthropic's coding assistant

Fully Supported
Bundled Feature

MCP Playground Included

MCP Shark comes bundled with an MCP playground where you can run commands and see results. Call tools, test prompts, and read resources—all without leaving the application. Perfect for debugging, exploring capabilities, and validating your MCP integrations.

Universal MCP Protocol Support

MCP Shark works with any IDE or application that implements the Model Context Protocol standard. As long as your IDE can connect to MCP servers via HTTP or stdio, MCP Shark can capture and analyze the traffic. With its integrated MCP playground for testing tools and resources, it's the perfect tool for developers using Cursor, Windsurf, Claude Code, or any other MCP-compatible development environment.

Features

MCP Playground

Featured

Integrated playground for safely testing tools, prompts, and resources. Perfect for debugging MCP server capabilities.

Local Analysis

Security

Static security analysis with YARA-based detection. Scan running servers for vulnerabilities based on MCP & Agentic Top 10.

Forensic Investigation

Deep dive into MCP communications with detailed request/response inspection for debugging and analysis

Traffic Capture

Capture all HTTP traffic between your IDE and MCP servers in real-time with comprehensive forensic capabilities

Advanced Filtering

Filter traffic by session, server, method, status, and more with multiple view modes for investigation

Real-Time Monitoring

Live web interface showing all MCP traffic as it happens with comprehensive search and inspection

Export for Analysis

Export captured traffic and logs in JSON, CSV, or TXT formats for further investigation and reporting

Multi-Server Support

Aggregate multiple MCP servers (HTTP and stdio) through a single unified endpoint for investigation

Investigate MCP Communications

MCP Shark is a powerful MCP proxy and traffic monitor designed for forensic investigation of Model Context Protocol (MCP) communications. MCP Shark acts as an intermediary gateway between your IDE and MCP servers, capturing and analyzing all HTTP requests and responses to provide deep visibility into every interaction. This MCP debugger enables you to monitor, filter, and audit all MCP traffic in real-time.

Perfect for investigating issues, debugging integrations, detecting suspicious MCP server behavior, or understanding exactly how your MCP servers communicate. MCP Shark gives you the forensic tools you need to inspect, filter, and export traffic for thorough investigation. The application includes an integrated MCP playground where you can safely test tools, prompts, and resources, plus Local Analysis for static security scanning with YARA-based detection rules.

How MCP Shark Works

A simple visual guide to understand the architecture and data flow

MCP Shark ArchitectureYour IDE(Cursor, Windsurf)Reads mcp.json(overwritten)HTTPMCP Shark ServerPort 9851Gateway • Logs • ManagesHTTP/stdioMCP ServersGitHub • FilesystemDatabase • CustomSQLite DatabaseAudit LoggingAll traffic loggedLogsMCP Shark UIPort 9853Reads DB • ControlsReadsControls
Request Flow

IDE connects directly to MCP Shark Server (mcp.json overwritten). Server acts as gateway to MCP servers.

UI & Logging

UI reads from SQLite DB in real-time and can start/stop the server. All traffic is logged automatically.

Response Flow

Responses flow back through MCP Shark Server to IDE. Server captures and logs everything.

How It Looks

MCP Shark LogoMCP Shark
No.TimeSourceDestinationMethodStatusEndpointLength
10.000000IDEMCP SharkPOST-/mcp1.20 KB
20.200000MCP SharkIDE-200/mcp856 B
30.500000IDEgithubPOST-tools/list2.40 KB
40.800000githubIDE-200tools/list3.34 KB
51.200000IDEMCP SharkPOST-/mcp892 B
61.500000MCP SharkIDE-200/mcp1.21 KB

How to Use

Get started with MCP Shark in just a few simple steps

Quick Tips

Traffic Capture Features

  • Use the search bar to find requests by method, URL, or JSON-RPC method
  • Filter by session ID to track a specific conversation
  • Filter by server name to see all traffic for a specific MCP server

View Modes

  • General List: View all requests in chronological order
  • Grouped by Session: Organize by session ID, then by server
  • Grouped by Server: Organize by server, then by session

npm Package Installation

Install MCP Shark via npm for command-line usage

Global Install

$npm install -g @mcp-shark/mcp-shark

Local Install

$npm install @mcp-shark/mcp-shark

npx (No Install)

$npx -y @mcp-shark/mcp-shark@latest
Terminal
$
npx -y @mcp-shark/mcp-shark@latest --open
Starting MCP Shark UI server...
Installing dependencies...
Building UI for production...
Open http://localhost:9853 in your browser
Opening browser...
Available flag:
--openor-oOpen browser automatically
Also works with: mcp-shark --open (after global install)

Frequently Asked Questions

Everything you need to know about MCP Shark

Report an Issue

Found a bug or have a feature request? Report it on GitHub.

MCP Shark Issues

Report bugs, request features, or ask questions about MCP Shark (Inspector).

Report Issue on GitHub