@mcp-shark/mcp-shark

Aggregate multiple Model Context Protocol (MCP) servers into a single unified interface with a powerful monitoring UI

Run instantly with npx (no installation required):

npx @mcp-shark/mcp-shark --open

The server will start on http://localhost:9853 and automatically open your browser.

Or install globally:

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

MCP Shark is a monitoring and aggregation solution for Model Context Protocol (MCP) servers. It provides:

• Multi-server aggregation: Connect to multiple MCP servers simultaneously
• Real-time monitoring: Wireshark-like interface for inspecting all MCP communications
• Interactive playground: Test tools, prompts, and resources directly in the UI
• Local analysis: Rule-based static analysis with YARA detection for connected servers
• Smart Scan: AI-powered scanning for security risks and vulnerabilities
• IDE integration: Automatic configuration detection for Cursor, Windsurf, Codex, and other IDEs
• API documentation: Comprehensive Swagger/OpenAPI documentation for all endpoints with interactive testing
• Action menu: Expandable menu providing quick access to API docs, help tour, and server shutdown

• Installation & Setup - Complete installation guide
• Quick Start Guide - Get up and running in minutes

• Features - Detailed feature documentation
• User Guide - Complete guide to using MCP Shark
• Local Analysis - Static security analysis with YARA detection
• Configuration - Configuration options and file formats
• Troubleshooting - Common issues and solutions

• Development Guide - Developer guide and contribution guidelines
• Architecture - System architecture and design
• Database Architecture - Database architecture and repository pattern
• API Reference - API endpoints and WebSocket protocol
• API Documentation - Interactive Swagger/OpenAPI documentation available at /api-docs when server is running (or click the menu button ☰ in the bottom-right corner, then select the API docs button 📡)

• Architecture Rules - Architecture principles and guidelines
• Database Architecture Rules - Database architecture rules
• Coding Rules - Coding standards and best practices
• Linting Rules - Linting configuration and rules

• Node.js: 20.0.0 or higher (for npm package)
• Operating System: macOS, Windows, or Linux

Source-Available Non-Commercial License

This is not an OSI-approved open source license. The source code is available, but commercial use is prohibited without a separate commercial agreement.

Summary:

• ✅ Allowed: View, fork, modify, and run for personal, educational, or internal company use
• ❌ Not Allowed: Sell, resell, or integrate into paid products/services without written permission

See the LICENSE file for full terms and conditions.

• mcp-shark-site: Official website and documentation
• smart-scan-web-app: Smart Scan web interface

• Documentation: docs/
• Issues: GitHub Issues
• Website: https://mcpshark.sh

Version: 1.5.9 | Homepage: https://mcpshark.sh