GitDiagram

com.gitdiagramPublished by gitdiagram.comOfficial publisherv1.0.0Updated Oct 24, 2026

Architecture diagrams, explanations and Mermaid source for public GitHub repositories.

VerifiedStreamable HTTPWeb executableKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Remote MCP server that gives an assistant architecture explanations, component maps and Mermaid diagrams of public GitHub repositories, plus explainer videos.

What you can do
  • Fetch a repository's architecture: written explanation, main components with source paths, how they connect, and a Mermaid flowchart
  • Search GitDiagram's stored diagram library by owner or repository name, returning up to 10 matches with links
  • Retrieve an existing narrated explainer video for a repository, with its title, length and full transcript
When to use it
Useful when you want a quick orientation to an unfamiliar public GitHub codebase, or want to compare or look up repositories by name without reading the source yourself. Also handy for pulling an existing one-minute project walkthrough.
Requirements
A remote MCP endpoint; no key or sign-in is needed for the hosted server. Any MCP client that supports remote HTTP servers can connect. Running it locally instead requires Bun, Cloudflare R2, Upstash Redis and an OpenAI or OpenRouter API key.
Before you install
The hosted tools cover public repositories only; private repositories need a GitHub token in the web app, not through this server. Explanations and diagrams are AI-generated, so treat them as a starting point rather than authoritative documentation. Video generation is in early access and only existing videos can be watched.

Installation

In SourceWeft

  1. Open GitDiagram in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.gitdiagram%2Fgitdiagram/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "gitdiagram": {
      "type": "http",
      "url": "https://gitdiagram.com/mcp"
    }
  }
}

README

GitDiagram

Visualize any codebase: turn any public or private GitHub repository into an interactive architecture diagram, or watch it explained in a one-minute narrated video. AI agents can use it too, through the MCP server or the Markdown version of any diagram (gitdiagram.com/owner/repo.md).

Try GitDiagram → · Or replace hub with diagram in any GitHub repository URL.

[GitDiagram front page]

[License] [Ko-fi]

[CodeRabbit]   Sponsored

AI code reviews for your pull requests. Try CodeRabbit →

New: explainer videos

GitDiagram can now turn a repository into a narrated video of about a minute. The video starts with what the project is for and what people do with it, then shows briefly how its main parts fit together and one decision under the hood.

[Watch GitDiagram explain itself in a minute]

  • Watch the gallery → or add /video to any diagram URL, such as gitdiagram.com/owner/repo/video.
  • Download an MP4 in landscape or vertical (9:16), with captions burned in.
  • Making new videos is in early access. Anyone can watch videos that already exist.

Features

  • Watch a repository explained in a narrated video, or press Video on any diagram page.
  • Explore the architecture with an AI-generated diagram and streamed explanation.
  • Jump to the code by clicking any component's linked file or directory.
  • Use private repositories with a GitHub token via Private Repos in the header.
  • Export diagrams as PNG or copy the Mermaid source.

Use GitDiagram from AI agents

GitDiagram is a remote MCP server at https://gitdiagram.com/mcp (no key or sign-in). Agents can read a public repository's architecture explanation, components, connections and Mermaid source, search the stored diagrams, and get explainer videos.

[Add to Claude] [Install in Cursor] [Install in VS Code] [Install in VS Code Insiders]

bash
# Claude Code: the plugin adds the MCP server and a /gitdiagram skillclaude plugin marketplace add ahmedkhaleel2004/gitdiagramclaude plugin install gitdiagram@gitdiagram# ...or just the MCP serverclaude mcp add --transport http gitdiagram https://gitdiagram.com/mcp
# Codexcodex mcp add gitdiagram --url https://gitdiagram.com/mcp
# Gemini CLIgemini extensions install https://github.com/ahmedkhaleel2004/gitdiagram
# GitHub Copilot CLIcopilot mcp add --transport http gitdiagram https://gitdiagram.com/mcp

In other clients (ChatGPT, Windsurf, Zed, LM Studio, Goose and more), add a remote MCP server with the URL https://gitdiagram.com/mcp. Then ask something like "how is fastapi/fastapi structured?".

Run locally

Requires Bun, Cloudflare R2, Upstash Redis, and an OpenAI or OpenRouter API key. See the setup guide for prerequisites and configuration.

bash
git clone https://github.com/ahmedkhaleel2004/gitdiagram.gitcd gitdiagrambun installcp .env.example .env

Fill in .env using the configuration guide, then start the app:

bash
bun run dev

Open localhost:3000.

Explainer videos are off by default. To turn them on, set VIDEO_EXPLAINER_ENABLED=1, NEXT_PUBLIC_VIDEO_EXPLAINER=1, ANTHROPIC_API_KEY, OPENAI_API_KEY and OPENROUTER_API_KEY (for the voice) in .env. See .env.example for the other video settings.

Development

Built with Next.js, React, TypeScript, Tailwind CSS, and Mermaid. Videos use Claude or GPT for the script and scenes and OpenRouter (Gemini 3.8 Flash TTS) for the voice. Deployed on Cloudflare Workers.

Contributions are welcome. Open an issue or pull request with a focused description and verification notes.

Inspired by Romain Courtois's Gitingest.

Source: README.md at commit f2a6d23

Tools

3

get_repository_diagram

Get a GitHub repository's architecture diagram

Get the architecture of a public GitHub repository from GitDiagram (gitdiagram.com): a written explanation of how the codebase is organized, its main components with the source paths they live in, how those components connect, and a Mermaid flowchart of the whole system, plus a link to the interactive diagram, where every component opens its code on GitHub. Use it whenever the user wants to understand, visualize, map or explain a GitHub repository's or open-source project's architecture, structure, main modules or data flow, wants an overview before reading unfamiliar code, or asks for an architecture or system diagram of a repo. Read-only and fast: it returns the diagram GitDiagram has already made. If none exists yet, it returns a link that makes one when opened in a browser. Public repositories only. In chat apps that show interactive views, the result also appears as a zoomable diagram whose components open their code on GitHub.

Parametersrepositoryrequired

find_repository_diagrams

Search GitDiagram's architecture diagrams

Search GitDiagram's library of ready-made architecture diagrams of public GitHub repositories by owner or repository name. Matches any part of "owner/repo" (e.g. "langchain", "vercel/", "react-native") and returns up to 10 repositories, most-starred first, each with its interactive diagram link. Use it to find a project's exact owner/repo from its name, or to list which repositories of an owner or topic already have diagrams. It searches repository names only, not code or file contents.

Parameterslimitqueryrequired

get_explainer_video

Get a GitHub repository's explainer video

Get GitDiagram's narrated explainer video of a public GitHub repository, if one has been made: the link to watch and share it, its title and length, and the full narration transcript, a plain-language walkthrough of what the project is for, what people do with it and how its main parts fit together. Use it when the user wants a video about a repository, something to watch or share instead of read, or a short spoken-style summary of a project. Read-only: it never makes a video; when none exists it says so and links the page where one can be made.

Parametersrepositoryrequired

Version history

1
  1. v1.0.0LatestSep 30, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts