2.0.1 • Published 4 months ago
repo-analysis-mcp v2.0.1
Repository Analysis MCP for Cursor
This is a custom MCP (Model Control Protocol) implementation for analyzing GitHub repositories directly in Cursor.
Features
- Get basic repository information
- Retrieve file contents from repositories
- List files in directories
- Analyze repository architecture and dependencies
Setup Instructions
Install Dependencies:
npm install
Configure GitHub Token:
- Create a GitHub personal access token with
repo
scope - Update the
GITHUB_TOKEN
inmcp-config.json
with your token
- Create a GitHub personal access token with
Configure Repositories:
- Set
SOURCE_REPO
to the main repository you want to analyze (format:owner/repo
) - Set
TARGET_REPOS
to comma-separated list of repositories to compare (format:owner/repo1,owner/repo2
)
- Set
Adding to Cursor
- Open Cursor
- Go to Settings > MCPs
- Click "Add MCP"
- Select "Import from file"
- Choose the
mcp-config.json
file from this directory
Available Tools
- get_repo_info: Get basic information about a GitHub repository
- get_file_content: Get the content of a file from a GitHub repository
- list_files: List files in a directory of a GitHub repository
- analyze_repository: Analyze a GitHub repository for patterns and architecture
Example Usage
Once configured in Cursor, you can use the MCP by typing commands like:
/Repository Analysis analyze_repository facebook/react
Or:
/Repository Analysis get_file_content facebook/react package.json
Troubleshooting
- If you encounter permission issues, make sure the script is executable:
chmod +x cursor-mcp.js
- If you see connection errors, verify your GitHub token is valid and has the necessary permissions
- Make sure the path in
mcp-config.json
points to the correct location ofcursor-mcp.js
License
MIT