# Top MCP Servers

A curated collection of top Model Context Protocol (MCP) servers for enhancing development workflows in 2025. This repository showcases various MCP implementations for different use cases including web automation, GitHub integration, and persistent memory management.

## Features

- **Web Automation MCPs**
  - Playwright MCP for headless browser automation
  - Puppeteer MCP for web interaction and screenshots
  
- **GitHub Integration MCP**
  - Repository management
  - Issue and PR handling
  - File operations
  - Code search capabilities
  
- **Memory MCP**
  - Persistent knowledge storage
  - Knowledge graph management
  - Cross-session context retention

## Example Prompts

Here are some example prompts to help you get started with each MCP:

### Web Automation Examples

1. **Playwright MCP - Weather Check**
```
"Use Playwright to check the current weather in New York City"
```
This will:
- Navigate to a weather service
- Extract current weather information
- Handle the page interaction headlessly

2. **Puppeteer MCP - Screenshot**
```
"Take a screenshot of the NASA astronomy picture of the day"
```
This will:
- Navigate to NASA's website
- Find the daily image
- Capture and save the screenshot

### GitHub Integration Examples

1. **Repository Management**
```
"Create a new repository called 'my-project' with a README and MIT license"
```
This will:
- Initialize a new GitHub repository
- Set up basic documentation
- Configure license

2. **Issue Management**
```
"Create an issue titled 'Add Dark Mode Support' with priority label"
```
This will:
- Create a new issue
- Add appropriate labels
- Set up task tracking

### Memory MCP Examples

1. **Knowledge Storage**
```
"Store information about the project's deployment process"
```
This will:
- Create entities for deployment steps
- Store configuration details
- Maintain deployment history

2. **Context Retention**
```
"What were the last changes made to the authentication system?"
```
This will:
- Query stored knowledge
- Retrieve relevant commit history
- Show related code changes

## Installation

1. Clone the repository:
```bash
git clone https://github.com/djpapzin/top-mcp-servers.git
cd top-mcp-servers
```

2. Install dependencies:
```bash
npm install
```

3. Configure environment variables:
Create a `.env` file with your GitHub token (do not commit this file):
```bash
GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here
```

## Usage

The repository includes various MCP configurations in `.cursor/mcp.json`. Each MCP can be used independently or in combination with others.

### Available MCPs

1. **Playwright MCP**
   - Headless browser automation
   - Web scraping
   - Page interaction

2. **GitHub MCP**
   - Repository operations
   - Issue management
   - Pull request handling

3. **Memory MCP**
   - Knowledge persistence
   - Entity relationship management
   - Context preservation

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

MIT

## Author

DJ Papzin (L.fanampe@gmail.com)

## Deployment

This project is deployed on render.com