github_directory_structureLABSCO SUMMARY
Two tools, and together they answer "how does this project work" in one exchange.
The pattern is always the same: get the tree, pick the handful of files that matter, read them. Because clones are keyed by a hash of the URL, follow-up questions about the same repository reuse the checkout instead of pulling it down again — which is what makes the back-and-forth bearable.
What it is
A two-tool server that clones a GitHub repository into a temporary directory and reads it — the structure, then whichever files you name.
What you get
- github_directory_structure — a tree view of a repository from its URL, with .git skipped
- github_read_important_files — the contents of the file paths you list, returned as a path-to-content mapping
- Repositories cached by a hash of their URL, so asking a second question about the same repo does not clone it again
- Temporary directories cleaned up after each call
Requirements
uvx, run straight from the repository with --from and the git URL. Python 3.8 or higher; it uses fastmcp and gitpython underneath. Nothing to authenticate for public repositories.
Setup effort
Add the configuration to your client
USE CASES
01
Understanding a library before you depend on it
Read the tree, then the entry point and config, without cloning anything yourself.
02
Answering a question about someone else's code
Give the URL and let the assistant fetch the specific files it needs to answer.
03
Getting the shape of an unfamiliar project
A tree view first tells you where things live before you read a line.
2 tools
Listed in project docs. Your client may show a different list.
github_read_important_filesBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
INSTALLATION
Connect your client
This one is configured rather than run — your client needs the configuration block, not a command.
Server setup
JSON
{
"mcpServers": {
"mcp-git-ingest": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/adhikasp/mcp-git-ingest",
"mcp-git-ingest"
]
}
}
}
