Skip to main content
ClaudeWave

Live sidebar, ER diagrams, CLI, and MCP server for Django models. VS Code + PyPI + MCP Registry + Glama. Zero-dep parser, no DB required.

MCP ServersOfficial Registry38 stars5 forksPythonMITUpdated today
Install in Claude Code / Claude Desktop
Method: pip / Python · django-orm-lens
Claude Code CLI
claude mcp add django-orm-lens -- python -m django-orm-lens
claude_desktop_config.json (Claude Desktop)
{
  "mcpServers": {
    "django-orm-lens": {
      "command": "python",
      "args": ["-m", "django-orm-lens"]
    }
  }
}
1. Run the command above in your terminal (Claude Code), or paste the JSON config into claude_desktop_config.json (Claude Desktop).
2. Replace any <placeholder> values with your API keys or paths.
3. Restart Claude. The MCP server and its tools appear automatically.
💡 Install first: pip install django-orm-lens
Use cases

MCP Servers overview

**English** · [Русский](docs/i18n/README.ru.md) · [Español](docs/i18n/README.es.md) · [中文](docs/i18n/README.zh.md)

<div align="center" markdown="1">

<img src="media/hero.png" alt="Django ORM Lens — live sidebar and ER diagram for your Django models" width="100%"/>

<br/>
<br/>

# Django ORM Lens

### See your entire Django schema — in your editor, in your terminal, and from your AI agent.

Every app. Every model. Every field. Every relationship. Grouped, navigable, and one keystroke away from a live ER diagram.

<br/>

<!-- 🏆 TROPHY ROW · third-party validation ────────────────────── -->

[![Merged into awesome-mcp-servers](https://img.shields.io/badge/%F0%9F%8F%86_Merged_into-awesome--mcp--servers_%C2%B7_91k_%E2%98%85-eab308?style=for-the-badge&labelColor=1e293b)](https://github.com/punkpeye/awesome-mcp-servers)
[![Open VSX verified](https://img.shields.io/badge/%E2%9C%93_Open_VSX-verified_by_Eclipse_Foundation-c160ef?style=for-the-badge&logo=eclipseide&logoColor=white&labelColor=1e293b)](https://open-vsx.org/extension/frowningdev/django-orm-lens)
[![MCP Registry official](https://img.shields.io/badge/%F0%9F%94%97_MCP_Registry-official_listing-6f42c1?style=for-the-badge&labelColor=1e293b)](https://registry.modelcontextprotocol.io/)

<br/>

<!-- Install channels ─────────────────────────────────────────── -->

[![Install from Marketplace](https://img.shields.io/badge/VS_Code-Install-0c4b33?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens)
[![Open VSX](https://img.shields.io/badge/Open_VSX-Install-c160ef?style=for-the-badge&logo=eclipseide&logoColor=white)](https://open-vsx.org/extension/frowningdev/django-orm-lens)
[![PyPI](https://img.shields.io/badge/PyPI-pip_install-3775a9?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/django-orm-lens/)
[![Glama score](https://images.weserv.nl/?url=glama.ai/mcp/servers/FROWNINGdev/django-orm-lens/badges/score%2Esvg&output=png)](https://glama.ai/mcp/servers/FROWNINGdev/django-orm-lens)
[![Smithery](https://images.weserv.nl/?url=smithery.ai/badge/%40frowningdev/django-orm-lens&output=png)](https://smithery.ai/server/@frowningdev/django-orm-lens)
[![mcp.so](https://img.shields.io/badge/mcp.so-listed-1f2937?style=for-the-badge)](https://mcp.so/servers/django-orm-lens)
[![Star on GitHub](https://img.shields.io/badge/★-Star_on_GitHub-24292f?style=for-the-badge&logo=github&logoColor=white)](https://github.com/FROWNINGdev/django-orm-lens)
[![Sponsor](https://img.shields.io/badge/♥-Sponsor-db61a2?style=for-the-badge&logo=githubsponsors&logoColor=white)](https://github.com/sponsors/FROWNINGdev)

<br/>

[![Version](https://img.shields.io/visual-studio-marketplace/v/frowningdev.django-orm-lens?color=0c4b33&label=extension&logo=visualstudiocode)](https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens)
[![Installs](https://img.shields.io/visual-studio-marketplace/i/frowningdev.django-orm-lens?color=0c4b33&label=installs)](https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens)
[![Rating](https://img.shields.io/visual-studio-marketplace/r/frowningdev.django-orm-lens?color=0c4b33&label=rating)](https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens&ssr=false#review-details)
[![PyPI version](https://img.shields.io/pypi/v/django-orm-lens?color=3775a9&label=pypi)](https://pypi.org/project/django-orm-lens/)
[![Python](https://img.shields.io/pypi/pyversions/django-orm-lens?color=3775a9)](https://pypi.org/project/django-orm-lens/)
[![License MIT](https://img.shields.io/badge/license-MIT-0c4b33?style=flat)](LICENSE)
[![CI](https://github.com/FROWNINGdev/django-orm-lens/actions/workflows/ci.yml/badge.svg)](https://github.com/FROWNINGdev/django-orm-lens/actions/workflows/ci.yml)

</div>

---

## 🎯 Pick your path

Django ORM Lens ships as **three distributions on one core** — pick the one that matches your workflow. Each takes under 60 seconds.

**Editor user (VS Code / Cursor / Windsurf / VSCodium / code-server / Gitpod):** install the extension → open any Django project → sidebar tree + ER diagram appear.

```bash
code --install-extension frowningdev.django-orm-lens          # VS Code, Cursor, Windsurf
codium --install-extension frowningdev.django-orm-lens        # VSCodium, code-server (via Open VSX)
```

**Terminal / CI user:** install from PyPI → run `django-orm-lens` in any directory that contains Django apps.

```bash
pip install django-orm-lens
django-orm-lens               # welcome + commands
django-orm-lens scan          # scan cwd for apps and models
```

**AI coding agent user (Cursor / Aider / Continue / Zed):** install with MCP extras → add one JSON block to your client config.

```bash
pip install "django-orm-lens[mcp]"
```

Then the MCP config snippet in the [Integrations](#-integrations) section below. Point `DJANGO_ORM_LENS_ROOT` at your Django project's absolute path.

---

## 📊 Traction

<div align="center" markdown="1">

<!-- Headline split-badges (dark label · colored value) -->

[![PyPI installs 30d](https://img.shields.io/badge/PyPI_installs_30d-2%2C833-3775a9?style=for-the-badge&logo=pypi&logoColor=white&labelColor=1e293b)](https://pypi.org/project/django-orm-lens/)
[![Peak day](https://img.shields.io/badge/peak_day_installs-793-f97316?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1e293b)](https://pypi.org/project/django-orm-lens/)
[![Unique cloners 14d](https://img.shields.io/badge/unique_cloners_14d-350-24292f?style=for-the-badge&logo=github&logoColor=white&labelColor=1e293b)](https://github.com/FROWNINGdev/django-orm-lens)
[![Marketplace rating](https://img.shields.io/badge/VS_Code_rating-5.0_%E2%98%85-c160ef?style=for-the-badge&logo=visualstudiocode&logoColor=white&labelColor=1e293b)](https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens)

<br/>

<!-- Cross-platform reach snapshot -->

[![VS Code installs](https://img.shields.io/badge/VS_Code_installs-11-0c4b33?style=for-the-badge&logo=visualstudiocode&logoColor=white&labelColor=1e293b)](https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens)
[![Open VSX verified](https://img.shields.io/badge/Open_VSX-verified_%E2%9C%93_836_dl-c160ef?style=for-the-badge&logo=eclipseide&logoColor=white&labelColor=1e293b)](https://open-vsx.org/extension/frowningdev/django-orm-lens)
[![GitHub views](https://img.shields.io/badge/GitHub_views_14d-745-24292f?style=for-the-badge&logo=github&logoColor=white&labelColor=1e293b)](https://github.com/FROWNINGdev/django-orm-lens)
[![LinkedIn posts](https://img.shields.io/badge/LinkedIn_posts_live-9-0a66c2?style=for-the-badge&logo=linkedin&logoColor=white&labelColor=1e293b)](https://linkedin.com/company/django-orm-lens)
[![awesome-mcp-servers](https://img.shields.io/badge/awesome--mcp--servers-merged_%E2%9C%93-16a34a?style=for-the-badge&logo=github&logoColor=white&labelColor=1e293b)](https://github.com/punkpeye/awesome-mcp-servers)
[![Awesome-list PRs](https://img.shields.io/badge/awesome--list_PRs-1_merged_%2B_2_open-16a34a?style=for-the-badge&logo=awesomelists&logoColor=white&labelColor=1e293b)](https://github.com/FROWNINGdev)
[![Community PRs merged](https://img.shields.io/badge/community_PRs_merged-8-8b5cf6?style=for-the-badge&logo=github&logoColor=white&labelColor=1e293b)](https://github.com/FROWNINGdev/django-orm-lens/pulls?q=is%3Apr+is%3Amerged+-author%3AFROWNINGdev)

<br/>

<!-- Live counters + directories -->

[![PyPI downloads total](https://img.shields.io/pepy/dt/django-orm-lens?style=for-the-badge&logo=pypi&logoColor=white&label=total%20downloads&labelColor=1e293b&color=3775a9)](https://pepy.tech/project/django-orm-lens)
[![PyPI weekly](https://img.shields.io/badge/weekly_downloads-2%2C015-3775a9?style=for-the-badge&logo=pypi&logoColor=white&labelColor=1e293b)](https://pepy.tech/project/django-orm-lens)
[![GitHub stars](https://img.shields.io/github/stars/FROWNINGdev/django-orm-lens?style=for-the-badge&logo=github&logoColor=white&label=stars&labelColor=1e293b&color=eab308)](https://github.com/FROWNINGdev/django-orm-lens/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/FROWNINGdev/django-orm-lens?style=for-the-badge&logo=github&logoColor=white&label=forks&labelColor=1e293b&color=64748b)](https://github.com/FROWNINGdev/django-orm-lens/network/members)

<br/>

<!-- MCP directories -->

[![MCP Registry](https://img.shields.io/badge/MCP_Registry-official_listing-6f42c1?style=for-the-badge&labelColor=1e293b)](https://registry.modelcontextprotocol.io/)
[![CodeTriage helpers](https://images.weserv.nl/?url=www.codetriage.com/frowningdev/django-orm-lens/badges/users%2Esvg&output=png)](https://www.codetriage.com/frowningdev/django-orm-lens)
[![Glama.ai score](https://images.weserv.nl/?url=glama.ai/mcp/servers/FROWNINGdev/django-orm-lens/badges/score%2Esvg&output=png)](https://glama.ai/mcp/servers/FROWNINGdev/django-orm-lens)
[![Smithery](https://images.weserv.nl/?url=smithery.ai/badge/%40frowningdev/django-orm-lens&output=png)](https://smithery.ai/server/@frowningdev/django-orm-lens)
[![mcp.so](https://img.shields.io/badge/mcp.so-listed-1f2937?style=for-the-badge&labelColor=1e293b)](https://mcp.so/servers/django-orm-lens)

<br/>

<!-- Tech stack + license -->

[![VS Code v0.7.8](https://img.shields.io/badge/VS_Code-v0.7.8-0c4b33?style=for-the-badge&logo=visualstudiocode&logoColor=white&labelColor=1e293b)](https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens)
[![Open VSX v0.7.8](https://img.shields.io/badge/Open_VSX-v0.7.8-c160ef?style=for-the-badge&logo=eclipseide&logoColor=white&labelColor=1e293b)](https://open-vsx.org/extension/frowningdev/django-orm-lens)
[![PyPI version](https://img.shields.io/pypi/v/django-orm-lens?style=for-the-badge&logo=pypi&logoColor=white&label=PyPI&labelColor=1e293b&color=3775a9)](https://pypi.org/project/django-orm-lens/)
[![Python](https://img.shields.io/pypi/pyversions/d
ai-agentsaidercode-navigationcursordatabasedeveloper-toolsdjangodjango-toolser-diagrammcpmcp-servermermaidmodel-context-protocolormpythonpython-clischema-diagramschema-visualizationstatic-analysisvscode-extension

What people ask about django-orm-lens

What is FROWNINGdev/django-orm-lens?

+

FROWNINGdev/django-orm-lens is mcp servers for the Claude AI ecosystem. Live sidebar, ER diagrams, CLI, and MCP server for Django models. VS Code + PyPI + MCP Registry + Glama. Zero-dep parser, no DB required. It has 38 GitHub stars and was last updated today.

How do I install django-orm-lens?

+

You can install django-orm-lens by cloning the repository (https://github.com/FROWNINGdev/django-orm-lens) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.

Is FROWNINGdev/django-orm-lens safe to use?

+

FROWNINGdev/django-orm-lens has not been audited yet by our security agent. Review the original repository on GitHub before using it in production.

Who maintains FROWNINGdev/django-orm-lens?

+

FROWNINGdev/django-orm-lens is maintained by FROWNINGdev. The last recorded GitHub activity is from today, with 1 open issues.

Are there alternatives to django-orm-lens?

+

Yes. On ClaudeWave you can browse similar mcp servers at /categories/mcp, sorted by popularity or recent activity.

Deploy django-orm-lens to your cloud

Ship this repo to production in minutes. Each platform spins up its own environment with editable env vars.

Maintain this repo? Add a badge to your README

Drop the badge into your GitHub README to show it's tracked on ClaudeWave. Each badge links back to this page and reflects the live Trust Score.

Featured on ClaudeWave: FROWNINGdev/django-orm-lens
[![Featured on ClaudeWave](https://claudewave.com/api/badge/frowningdev-django-orm-lens)](https://claudewave.com/repo/frowningdev-django-orm-lens)
<a href="https://claudewave.com/repo/frowningdev-django-orm-lens"><img src="https://claudewave.com/api/badge/frowningdev-django-orm-lens" alt="Featured on ClaudeWave: FROWNINGdev/django-orm-lens" width="320" height="64" /></a>

More MCP Servers

django-orm-lens alternatives