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

1. Install Dependencies:

   npm install

2. Configure GitHub Token:

   • Create a GitHub personal access token with repo scope
   • Update the GITHUB_TOKEN in mcp-config.json with your token

3. 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)

Adding to Cursor

1. Open Cursor
2. Go to Settings > MCPs
3. Click "Add MCP"
4. Select "Import from file"
5. 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 of cursor-mcp.js

License

MIT