@mcp-shark/mcp-shark

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

Quick Start

Desktop Application

Download the native desktop application for macOS, Windows, or Linux:

The desktop application provides a native experience with automatic updates and system integration. No Node.js installation required.

npm Package

Install globally:

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

Run:

mcp-shark --open

Or use npx (no installation):

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

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

What is MCP Shark?

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
• Security analysis: 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

Documentation

Getting Started

• Installation & Setup - Complete installation guide for desktop app and npm package
• Quick Start Guide - Get up and running in minutes

User Guides

• Features - Detailed feature documentation
• User Guide - Complete guide to using MCP Shark
• Configuration - Configuration options and file formats
• Troubleshooting - Common issues and solutions

Developer Guides

• 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 & Coding Rules

• 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

Requirements

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

License

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.

Related Projects

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

Support

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

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