GitHub URL MCP Server
An MCP (Model Context Protocol) server for handling GitHub URLs with validation and parsing capabilities.
This server provides tools to convert between GitHub repository information and URLs, with intelligent validation to distinguish between public repositories, private repositories, and non-existent repositories.
Background
This tool was created to solve the problem where LLMs often struggle to properly handle GitHub-related tasks and fail to appropriately call MCP tools for GitHub operations. Many LLMs have difficulty constructing correct GitHub URLs from repository information, parsing GitHub URLs to extract meaningful components, or knowing when to use available MCP tools for GitHub-related requests. This server provides specialized tools that make these operations reliable and consistent for AI applications.
Note: This issue might be specific to the LLMs I commonly use, but providing dedicated tools ensures consistent behavior across different AI systems. Or perhaps I should just quietly invest a fortune in Claude Code's max plan instead.
Features
- URL Building: Convert owner/repo pairs to properly formatted GitHub URLs
- URL Parsing: Extract owner, repository, and path information from GitHub URLs
- Smart Repository Validation: Distinguish between public, private, and non-existent repositories
- Private Repository Detection: Identify when a repository exists but is private
- Comprehensive Status Reporting: Clear status indicators for repository accessibility
- Error Handling: Detailed error messages for invalid inputs
- No Authentication Required: Works without GitHub API tokens
- Timeout Protection: Network requests have built-in timeouts
Tools
github/build_url
Converts GitHub owner and repository name into a properly formatted GitHub URL with validation.
Parameters:
owner(string): GitHub username or organization namerepo(string): Repository name
Example:
{
"owner": "microsoft",
"repo": "vscode"
}
Returns:
https://github.com/microsoft/vscode(for public repositories)https://github.com/owner/repo+ 🔒 Note (for private repositories)https://github.com/owner/repo+ ⚠️ Warning (for non-existent repositories)https://github.com/owner/repo+ ❌ Error (for validation errors)
github/parse_url
Parses a GitHub URL to extract owner, repository name, and additional path information with validation.
Parameters:
url(string): GitHub URL to parse
Example:
{
"url": "https://github.com/microsoft/vscode/tree/main/src"
}
Returns:
{
"owner": "microsoft",
"repo": "vscode",
"url": "https://github.com/microsoft/vscode",
"additionalPath": "tree/main/src",
"status": "public",
"accessible": true
}
Status Values:
"public": Repository is publicly accessible"private": Repository exists but is private"not_found": Repository does not exist"error": Validation error occurred
Additional Fields:
accessible: Boolean indicating if the repository is publicly accessiblenote: Information message for private repositorieswarning: Warning message for non-existent repositorieserror: Error message for validation failures
Development
Setup
npm install
Start the server
npm run start
Development mode with CLI interaction
npm run dev
Testing
npm run test
Linting and formatting
npm run lint
npm run format
Build
npm run build