GitDiagram

com.gitdiagram由 gitdiagram.com 发布官方发布者v1.0.0更新于 Oct 24, 2026

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

已验证Streamable HTTP可网页运行知识与记忆开发者工具

概览

AI 生成的概览

远程 MCP 服务器，让助手获取公开 GitHub 仓库的架构说明、组件构成与 Mermaid 流程图，以及讲解视频。

可以做什么
  • 获取仓库架构：文字说明、带源码路径的主要组件、组件之间的连接关系以及整体 Mermaid 流程图
  • 按所有者或仓库名搜索 GitDiagram 已存的图表库，最多返回 10 个匹配结果及链接
  • 获取某个仓库已有的旁白讲解视频，包括标题、时长和完整文字稿
适用场景
适合在需要快速了解一个陌生的公开 GitHub 代码库时使用，或按名称查找、比较仓库而无需自己通读源码。也可用于调取已有的约一分钟项目讲解视频。
运行要求
远程 MCP 端点；托管服务无需密钥或登录。任何支持远程 HTTP 服务器的 MCP 客户端均可连接。若改为本地运行，则需要 Bun、Cloudflare R2、Upstash Redis 以及 OpenAI 或 OpenRouter 的 API 密钥。
安装前请注意
托管工具仅覆盖公开仓库；私有仓库需在网页端使用 GitHub 令牌，而非通过此服务器。架构说明和图表由 AI 生成，应作为入门参考而非权威文档。视频生成处于早期访问阶段，目前只能观看已存在的视频。

安装

在 SourceWeft 中

  1. 打开 控制台中的 GitDiagram，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.gitdiagram%2Fgitdiagram/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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.

来源：README.md，提交 f2a6d23

工具

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.

输入参数repository必填

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.

输入参数limitquery必填

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.

输入参数repository必填

版本历史

1
  1. v1.0.0最新Sep 30, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分