GitDiagram MCP
The GitDiagram MCP and plugin give an agent the architecture map of a public GitHub repository with Mermaid source.
- 18,884 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The repository names you ask about go to the external gitdiagram.com service.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/gitdiagramDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The repository names you ask about go to the external gitdiagram.com service.
This is third-party code. Review the repository files before installing.
What it does
GitDiagram turns a public GitHub repository into an interactive architecture diagram. For agents there is a remote MCP server at `https://gitdiagram.com/mcp` with no key or sign-in: it returns a written architecture explanation, the main components with source paths, how they connect and the Mermaid source, searches stored diagrams and serves explainer videos. The repository holds a Claude Code plugin that adds the MCP server and a `/gitdiagram` skill. The skill finds the exact `owner/repo` through `find_repository_diagrams`, calls `get_repository_diagram` and answers with a short overview, the components and a link to the interactive diagram. The fallback without MCP: `gitdiagram.com/owner/repo.md` returns the same diagram as Markdown.
Who it is for. People getting to know an unfamiliar codebase or studying an open source project who want an architecture overview from an agent in Claude Code, Codex or Cursor.
Good fit when
- The agent explains the structure of an unfamiliar repository before a first commit to it.
- Documentation needs a Mermaid diagram of an open source project architecture.
- Two libraries are compared by their structure and component connections.
- The agent looks for a component in a project using the path list from the diagram.
Not a fit when
- The repository is private: diagrams are available for public repositories only.
- An exact code review is needed: the diagrams are AI-made and need checking against the source.
- An instant diagram of a fresh repository is needed: if none exists, the site makes it in about a minute.
Example request
Explain the architecture of `fastapi/fastapi`: main components with source paths and a Mermaid diagram.MCP
- Transport
- http
- Authentication
- not required
Limitations
The MCP works with public GitHub repositories. Diagrams are made by AI, so specific claims should be checked against the source. If a repository has no diagram yet, the tool returns a link where the site makes one for free in about a minute, after which the request is repeated. The server is remote and repository names go to `gitdiagram.com`. The Claude Code plugin installs from the marketplace in this repository, and other clients only need the MCP address.
How to disable. Remove the plugin in the Claude Code plugin manager or the server with `claude mcp remove gitdiagram`. In other clients delete the `gitdiagram` entry from the settings.
FAQ
How do I install the Claude Code plugin?
Run `claude plugin marketplace add ahmedkhaleel2004/gitdiagram` and `claude plugin install gitdiagram@gitdiagram`. The plugin adds the MCP server and the `/gitdiagram` skill.
How do I connect only the MCP?
Run `claude mcp add --transport http gitdiagram https://gitdiagram.com/mcp`. For Codex: `codex mcp add gitdiagram --url https://gitdiagram.com/mcp`.
Are a key or sign-in needed?
No, the README says the server works without a key or sign-in.
What if there is no diagram?
Open the link from the response: the site makes the diagram for free in about a minute. Then ask the agent to read it again.
Is there a path without MCP?
Yes. The address `gitdiagram.com/owner/repo.md` returns the same diagram as Markdown, and a 404 means there is no diagram yet.
Discussion
No questions or reviews yet.
Related
MCP serversDeep Graph MCP: a code graph of a repository for agents
Deep Graph MCP
An MCP server that gives an agent a repository code graph: search by meaning, symbol links and the places an edit would touch
A remote MCP server that gives the agent docs and code of any public GitHub repository with nothing to install
An MCP server builds a graph of code entities, relations and flows so the agent finds the right files without reading everything
Local code structure graph: builds a repository map with tree-sitter and serves the assistant only the context a change actually touches over MCP
Indexes a codebase into a knowledge graph and gives the agent call chains, change blast radius and code search over MCP
Code graph and project memory in one Rust program: the agent gets excerpts with file and line citations
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| GitDiagram (this card) | yes | not required | 18,884 | |
| GitMCP | no | not required | 8,513 | connects an agent to repository docs and code; GitDiagram returns a ready architecture map and Mermaid source |
| Repomix | no | not required | 29,240 | packs a repository into one file for a model; GitDiagram returns a breakdown of components and connections |
README in short
The README covers the site, the keyless MCP server, install buttons for Claude, Cursor and VS Code, commands for Claude Code, Codex and Copilot and the Markdown version of diagrams.