MCP Explorer

A web-based GUI for exploring and interacting with Model Context Protocol (MCP) servers. Connect to any MCP server, browse its capabilities, and execute tools, read resources, and test prompts — all from your browser.

Features

• Connect to any MCP server — supports both Streamable HTTP and SSE transports (auto-detects)
• Authentication — Bearer token, custom header, or no auth
• Browse Tools — list all tools, view schemas, fill in parameters, and execute them
• Browse Resources — list and read resources exposed by the server
• Browse Prompts — list prompts, fill in arguments, and retrieve rendered output
• Parameter Store — save and reuse frequently used parameter values across sessions
• URL History — remembers previously connected server URLs
• Clean UI — minimal, responsive interface with tabbed navigation

Quick Start

Prerequisites

• Python 3.13+
• uv (recommended) or pip

Install & Run

# Clone the repo
git clone https://github.com/ventz/mcp-explorer.git
cd mcp-explorer

# Install dependencies
uv sync

# Run the server
uv run python app.py

Open http://localhost:8000 in your browser.

Using pip

pip install fastapi 'uvicorn[standard]' jinja2 mcp
python app.py

Usage

1. Enter an MCP server URL (e.g., http://localhost:3000/mcp)
2. Optionally configure authentication (Bearer token or custom header)
3. Click Connect
4. Use the tabs to explore Tools, Resources, and Prompts
5. Select an item to view its details, fill in parameters, and execute

Project Structure

mcp-explorer/
├── app.py              # FastAPI backend — MCP client + API routes
├── pyproject.toml       # Python project metadata & dependencies
├── templates/
│   └── index.html       # Main HTML template
└── static/
    ├── app.js           # Frontend application logic
    └── style.css        # Styles

API Endpoints

| Method | Path | Description | |--------|---------------------|------------------------------| | GET | / | Web UI | | POST | /api/connect | Connect to an MCP server | | POST | /api/disconnect | Disconnect | | GET | /api/status | Connection status | | GET | /api/tools | List available tools | | POST | /api/tools/call | Execute a tool | | GET | /api/resources | List available resources | | POST | /api/resources/read | Read a resource | | GET | /api/prompts | List available prompts | | POST | /api/prompts/get | Get a rendered prompt |

License

MIT