mcp-lens-ui

# MCP Lens **MCP Lens** is the Swagger UI equivalent for the **Model Context Protocol (MCP)**. It provides a beautiful, interactive, and dark-themed web interface to explore, execute, and debug your MCP servers locally. MCP Lens automatically intercepts calls to your MCP Server (using `fastmcp`), aggregates the schema of all available tools, resources, and prompts, and instantly spins up a local web UI. --- ## 🚀 Features - 🛠 **Tools Explorer**: View all available tools, their JSON schemas, and test them with a live form. See execution traces and server responses. - 📚 **Resources Explorer**: Browse all standard and dynamically paginated resources exposed by your MCP servers and inspect their values instantly. - 💬 **Prompts Explorer**: View predefined prompt templates and invoke them dynamically to see exactly how they will format for LLMs. - 📜 **Request History**: Keep a log of all executions along with performance metrics (execution time, status codes) and effortlessly replay them. - 🔐 **Multi-Server & Auth**: Supports instrumenting multiple MCP servers concurrently and provides an interface for Bearer token authorizations per server. --- ## 📦 Installation To use MCP Lens in your project, simply install it via pip: ```bash pip install mcp-lens-ui ``` *(Note: Ensure your MCP server is built using the `fastmcp` package.)* --- ## ⚡ How to Use Using MCP Lens is incredibly easy. Just import `instrument` from `mcp_lens` and wrap your `FastMCP` app instances. ### Minimal Example (`example.py`) Here is a full example showing how to create a basic weather MCP server and visualize it with MCP Lens. ```python import httpx from fastmcp import FastMCP from mcp_lens import instrument app = FastMCP("OpenMeteo Weather") @app.tool() async def get_current_weather(latitude: float, longitude: float) -> str: """Get the current weather for a specific latitude and longitude. Uses Open-Meteo free API.""" url = f"https://api.open-meteo.com/v1/forecast?latit…