GitHub Repo Extractor▌
by kazuph
Connect to GitHub repos and query code, dependencies, and history using GitHub API and webhooks for actionable insights.
Connects to GitHub repositories, enabling natural language queries about code structure, dependencies, and development history.
Both formats append explainx.ai attribution and the canonical URL for this MCP server listing.
best for
- / Developers analyzing unfamiliar codebases
- / Code reviews and architectural analysis
- / Learning from open source projects
capabilities
- / Retrieve entire repository codebases as single files
- / Filter code by specific directories or file extensions
- / Extract individual files from repositories
- / Show repository structure and README files
- / Access specific branches beyond main/master
what it does
Extracts code from GitHub repositories and makes it available for analysis through natural language queries in Claude.
about
GitHub Repo Extractor is a community-built MCP server published by kazuph that provides AI assistants with tools and capabilities via the Model Context Protocol. Connect to GitHub repos and query code, dependencies, and history using GitHub API and webhooks for actionable insights. It is categorized under search web, developer tools. This server exposes 1 tool that AI clients can invoke during conversations and coding sessions.
how to install
You can install GitHub Repo Extractor in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
license
MIT
GitHub Repo Extractor is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
readme
GitHub MCP Server for Pera1
A Model Context Protocol server that connects GitHub code to Claude.ai. This server utilizes the Pera1 service to extract code from GitHub repositories and provide better context to Claude.
<a href="https://glama.ai/mcp/servers/m2sd6ew3wf"><img width="380" height="200" src="https://glama.ai/mcp/servers/m2sd6ew3wf/badge" alt="@kazuph/mcp-github-pera1 MCP server" /></a>
Setup
Add the following to your MCP config file (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@kazuph/mcp-github-pera1"]
}
}
}
Now you can ask Claude about GitHub code repositories.
Parameters
url: GitHub repository URL (required)dir: Filter files by directory paths (comma-separated)ext: Filter files by extensions (comma-separated)mode: Display mode (e.g.,treeshows directory structure and README files only)branch: Specify the branch to fetch fromfile: Specify a single file to retrieve
Usage Examples
You can ask Claude questions like:
Tell me about the implementation of GitHub repository https://github.com/username/repository
For specific directories:
Explain the components in https://github.com/username/repository?dir=src/components
For a specific file:
Show me the Button component from https://github.com/username/repository?file=src/components/Button.tsx
For directory structure with README files only:
Show me the structure of https://github.com/username/repository?mode=tree
For a specific branch:
Analyze the develop branch of https://github.com/username/repository?branch=develop
License
MIT
Author
kazuph (https://x.com/kazuph)
FAQ
- What is the GitHub Repo Extractor MCP server?
- GitHub Repo Extractor is a Model Context Protocol (MCP) server profile on explainx.ai. MCP lets AI hosts (e.g. Claude Desktop, Cursor) call tools and resources through a standard interface; this page summarizes categories, install hints, and community ratings.
- How do MCP servers relate to agent skills?
- Skills are reusable instruction packages (often SKILL.md); MCP servers expose live capabilities. Teams frequently combine both—skills for workflows, MCP for APIs and data. See explainx.ai/skills and explainx.ai/mcp-servers for parallel directories.
- How are reviews shown for GitHub Repo Extractor?
- This profile displays 66 aggregated ratings (sample rows for discoverability plus signed-in user reviews). Average score is about 4.6 out of 5—verify behavior in your own environment before production use.
Use Cases▌
Web Research & Information Gathering
Fetch and extract information from websites automatically
Example
Research competitor pricing, scrape product reviews, monitor news mentions
Automate 5-10 hours/week of manual web research
Content Monitoring & Alerts
Track website changes, new content, price updates
Example
Monitor competitor blog for new posts, track stock availability, watch for pricing changes
Stay informed without manual checking, never miss important updates
Data Extraction & Aggregation
Extract structured data from multiple websites
Example
Compile product listings from 10 e-commerce sites, aggregate job postings, collect real estate data
Build datasets 100x faster than manual copying
API-less Integration
Interact with services that don't offer APIs
Example
Check form submissions, validate website functionality, test user flows
Automate interactions with any website, even without API
Implementation Guide▌
Prerequisites
- ›Claude Desktop or Cursor with MCP support
- ›Understanding of web scraping ethics and robots.txt
- ›Rate limiting awareness to avoid overwhelming target sites
- ›Knowledge of legal restrictions on data collection
Time Estimate
20-40 minutes including configuration and testing
Installation Steps
- 1.Install web automation MCP server via npm or pip
- 2.Configure allowed domains and rate limits in MCP config
- 3.Test with simple fetch: 'Get content from example.com'
- 4.Progress to extraction: 'Extract all product prices from this page'
- 5.Set up monitoring: 'Check this URL daily for changes'
- 6.Parse structured data: 'Create CSV from this table'
- 7.Respect robots.txt and rate limits always
Troubleshooting
- ⚠403 Forbidden: Website blocks bots—respect their wishes, use official API instead
- ⚠Rate limit errors: Slow down requests, add delays between fetches
- ⚠Stale data: Target site changed HTML structure—update selectors
- ⚠Timeout errors: Site is slow or blocking—increase timeout, try different user agent
- ⚠JavaScript-rendered content: Use headless browser MCP servers for dynamic sites
Best Practices▌
✓ Do
- +Check robots.txt and respect crawl rules
- +Rate limit requests: 1-2 requests/second maximum
- +Use official APIs when available instead of scraping
- +Identify your bot with descriptive user agent
- +Cache results to minimize repeated requests
- +Handle errors gracefully with retries and fallbacks
- +Validate extracted data for accuracy
✗ Don't
- −Don't scrape sites that explicitly forbid it (robots.txt, ToS)
- −Don't overwhelm servers with rapid requests—use rate limiting
- −Don't scrape personal data without consent and legal basis
- −Don't ignore copyright on extracted content
- −Don't assume HTML structure is stable—handle changes
- −Don't use scraped data for commercial purposes without permission
💡 Pro Tips
- ★Use CSS selectors or XPath for robust data extraction
- ★Set up monitoring alerts for extraction failures (structure changed)
- ★Implement exponential backoff for retries on failures
- ★Store raw HTML for reprocessing if extraction logic changes
- ★Combine with data analysis tools for insights from extracted data
- ★Consider using official APIs or RSS feeds as more stable alternatives
Technical Details▌
Architecture
MCP server handles HTTP requests, HTML parsing, JavaScript rendering (if headless browser), and returns structured data to Claude.
Protocols
- HTTP/HTTPS
- WebSocket (for real-time sites)
- Puppeteer/Playwright (for JavaScript sites)
Compatibility
- Static HTML sites
- JavaScript-rendered SPAs (with headless browser)
- REST APIs
- GraphQL endpoints
When to Use This▌
✓ Use When
Use for research automation, content monitoring, data aggregation from multiple sources, and when official APIs don't exist. Best for read-only information gathering.
✗ Avoid When
Avoid for sites with APIs (use API instead), sites that explicitly forbid scraping, when data is copyrighted, or for login-required content without proper authorization.
Integration▌
- →Scheduled monitoring with change detection
- →Multi-source data aggregation pipelines
- →Fallback to web scraping when API rate limits hit
- →Headless browser for JavaScript-heavy sites
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
List & Promote Your MCP Server
Share your MCP server with the developer community
Ratings
4.6★★★★★66 reviews- ★★★★★Omar Chawla· Dec 28, 2024
GitHub Repo Extractor has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
- ★★★★★Layla Iyer· Dec 20, 2024
Strong directory entry: GitHub Repo Extractor surfaces stars and publisher context so we could sanity-check maintenance before adopting.
- ★★★★★Pratham Ware· Dec 8, 2024
We evaluated GitHub Repo Extractor against two servers with overlapping tools; this profile had the clearer scope statement.
- ★★★★★Yusuf Chawla· Dec 4, 2024
Useful MCP listing: GitHub Repo Extractor is the kind of server we cite when onboarding engineers to host + tool permissions.
- ★★★★★Layla Bansal· Nov 23, 2024
Strong directory entry: GitHub Repo Extractor surfaces stars and publisher context so we could sanity-check maintenance before adopting.
- ★★★★★Liam Garcia· Nov 19, 2024
GitHub Repo Extractor is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
- ★★★★★Aditi Sanchez· Nov 11, 2024
Useful MCP listing: GitHub Repo Extractor is the kind of server we cite when onboarding engineers to host + tool permissions.
- ★★★★★Layla Gill· Oct 14, 2024
I recommend GitHub Repo Extractor for teams standardizing on MCP; the explainx.ai page compares cleanly with sibling servers.
- ★★★★★Kofi Wang· Oct 10, 2024
We wired GitHub Repo Extractor into a staging workspace; the listing’s GitHub and npm pointers saved time versus hunting across READMEs.
- ★★★★★Isabella White· Oct 2, 2024
GitHub Repo Extractor reduced integration guesswork — categories and install configs on the listing matched the upstream repo.
showing 1-10 of 66