https://github.com/ventz/mcp-explorer
MCP Explorer - because the official NXP Inspector (@modelcontextprotocol/inspector) is terrible! Also this has an API layer!
https://github.com/ventz/mcp-explorer
mcp mcp-client mcp-explorer modelcontextprotocol
Last synced: 4 months ago
JSON representation
MCP Explorer - because the official NXP Inspector (@modelcontextprotocol/inspector) is terrible! Also this has an API layer!
- Host: GitHub
- URL: https://github.com/ventz/mcp-explorer
- Owner: ventz
- License: mit
- Created: 2026-03-20T03:13:01.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-03-20T03:18:56.000Z (5 months ago)
- Last Synced: 2026-03-20T19:29:54.848Z (5 months ago)
- Topics: mcp, mcp-client, mcp-explorer, modelcontextprotocol
- Language: JavaScript
- Homepage:
- Size: 13.7 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MCP Explorer
A web-based GUI for exploring and interacting with [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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](https://docs.astral.sh/uv/) (recommended) or pip
### Install & Run
```bash
# 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](http://localhost:8000) in your browser.
### Using pip
```bash
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