https://github.com/kazuph/mcp-github-pera1
https://github.com/kazuph/mcp-github-pera1
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/kazuph/mcp-github-pera1
- Owner: kazuph
- License: mit
- Created: 2024-12-09T05:12:51.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-03-03T14:15:51.000Z (4 months ago)
- Last Synced: 2025-04-17T22:28:26.119Z (2 months ago)
- Language: JavaScript
- Size: 60.5 KB
- Stars: 2
- Watchers: 1
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- mcp-index - GitHub MCP Server for Pera1 - Connects GitHub code to Claude.ai for context enhancement through code extraction using the Pera1 service. (Developer Tools)
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.
### Setup
Add the following to your MCP config file (`~/Library/Application Support/Claude/claude_desktop_config.json`):
```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., `tree` shows directory structure and README files only)
- `branch`: Specify the branch to fetch from
- `file`: 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)