Getting Started

Install MCP Lens and start inspecting your MCP server tools in minutes.

Prerequisites

  • Python 3.11+
  • Node.js 18+
  • uv or pip

Setup

git clone https://github.com/devninja-in/mcp-lens.git && cd mcp-lens
make setup    # interactive setup
make start    # starts backend + frontend

make setup presents a menu:

  1. Quick setup — installs dependencies, creates .env with defaults
  2. Configure LLM evaluation — prompts for provider, model, API key
  3. Configure all settings — ports, database, OAuth persistence, LLM config

Manual Setup

uv sync
cd src/frontend && npm install && cd ../..
cp .env.example .env    # edit with your config

Start the App

make start     # starts both backend and frontend
make stop      # stops both
make restart   # restart both

Or start manually:

uv run uvicorn src.app.main:app --reload --port 5002 &
cd src/frontend && npm run dev &

Open http://localhost:5173

Manual Tool Upload

When an MCP server is unreachable, download a YAML template, fill in tool definitions, and upload. YAML format example:

tools:
  - name: my_tool
    description: Does something useful
    inputSchema:
      type: object
      properties:
        param1:
          type: string
          description: A required parameter
      required:
        - param1

Docker

docker compose up