🌍 Universal MCP Servers Collection

> A comprehensive, production-ready collection of Model Context Protocol (MCP) servers with performance optimizations, bug fixes, and universal configurations.

🚀 What's Included

🎯 5 Production-Ready MCP Servers

🔧 Performance Fixes Applied

🚨 CRITICAL PyMuPDF4LLM Performance Bug Fixed

• Issue: PDF processed twice when using `save_path` (2x processing time)
• Solution: Eliminated duplicate `pymupdf4llm.to_markdown()` calls
• Result: 50% performance improvement for file operations
• Additional Fix: Server startup log level validation error resolved

📊 Quick Comparison

Before vs After Performance

🛠️ Quick Start

1. Clone & Install

git clone https://github.com/Mgabr90/universal-mcp-servers.git
cd universal-mcp-servers

# Quick installation (Windows)
.\scripts\setup\quick-install.ps1

2. Configure Your Client

🎯 Cursor IDE:

{
  "mcpServers": {
    "github-universal": {
      "command": "github-mcp-server",
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "your_token" }
    },
    "pymupdf4llm-fixed": {
      "command": "python",
      "args": ["C:/path/to/universal-mcp-servers/servers/pymupdf4llm-mcp/app.py"]
    }
  }
}

💬 Claude Desktop:

• Copy `configs/claude-desktop/claude_desktop_config.json`
• Update paths and add your API tokens
• Restart Claude Desktop

3. Test Your Setup

"List my GitHub repositories"
"Convert this PDF to markdown"
"List my Vercel deployments"
"Take a screenshot of this webpage"
"Read data from this Excel file"

🎯 Real-World Usage Examples

GitHub Workflow Automation

🤖 "Search for Python repositories with machine learning topics"
🤖 "Fork the most popular one to my account"
🤖 "Create a new branch called 'feature-documentation'"
🤖 "Create an issue about improving the README"
🤖 "Create a pull request with documentation improvements"

PDF Processing Pipeline

🤖 "Convert this aviation regulation PDF to markdown"
🤖 "Extract all images and save them to a separate folder"
🤖 "Process this 200-page technical manual efficiently"
📊 Result: 50% faster processing than original implementation

Vercel Deployment Management

🤖 "List my recent deployments and their status"
🤖 "Create a new project called 'universal-dashboard'"
🤖 "Set up environment variables for production"
🤖 "Deploy the latest version with custom domains"

Excel Data Analysis

🤖 "Read the sales data from the Q4 spreadsheet"
🤖 "Create a summary table with totals and percentages"
🤖 "Add formulas to calculate year-over-year growth"
🤖 "Take a screenshot of the final dashboard"

📁 Repository Structure

📦 universal-mcp-servers/
├── 🖥️  servers/
│   ├── 📄 pymupdf4llm-mcp/     # Performance-fixed PDF processing
│   │   ├── app.py             # ⚡ 50% faster implementation
│   │   ├── pyproject.toml     # Dependencies and configuration
│   │   └── README.md          # Performance fix documentation
├── ⚙️  configs/
│   ├── 🎯 cursor/             # Cursor IDE configurations
│   └── 💬 claude-desktop/     # Claude Desktop configurations
├── 📜 scripts/
│   ├── 🛠️  setup/             # Installation and setup scripts
│   └── 🪟 windows/           # Windows-specific utilities
├── 📚 docs/
│   ├── 📖 setup-guides/       # Detailed setup instructions
│   ├── 🆘 troubleshooting/    # Problem resolution guides
│   └── 📋 api-documentation/  # Complete API reference
└── 📄 README.md              # This file

🔧 Server Details

🐙 GitHub MCP Server (50+ Tools)

🎯 Repository Management:

• `create_repository`, `fork_repository`, `search_repositories`
• `get_file_contents`, `create_or_update_file`, `delete_file`, `push_files`

📋 Issue & PR Workflows:

• `create_issue`, `update_issue`, `add_issue_comment`
• `create_pull_request`, `merge_pull_request`, `request_copilot_review`

🔍 Search & Discovery:

• `search_code`, `search_issues`, `search_users`, `search_repositories`

🔔 Notifications:

• `list_notifications`, `mark_all_notifications_read`, `dismiss_notification`

🔒 Security:

• `list_code_scanning_alerts`, `list_secret_scanning_alerts`

🚀 Vercel MCP Server (11+ Tools)

📦 Deployment Management:

• `vercel-list-all-deployments`, `vercel-get-deployment`
• `vercel-create-deployment`, `vercel-list-deployment-files`

🏗️ Project Configuration:

• `vercel-list-projects`, `vercel-create-project`
• `vercel-get-environments`, `vercel-create-environment-variables`

👥 Team Management:

• `vercel-list-all-teams`, `vercel-create-team`

📄 PyMuPDF4LLM MCP (Performance Fixed)

⚡ PDF Processing:

• `convert_pdf_to_markdown` - 50% faster than original
• Image extraction and referencing
• Large file support with chunking
• Reliable server startup

🔧 Technical Improvements:

# ❌ Original (slow - duplicate processing)
content = pymupdf4llm.to_markdown(file_path)
if save_path:
    content = pymupdf4llm.to_markdown(file_path)  # DUPLICATE!

# ✅ Fixed (fast - single processing)
content = pymupdf4llm.to_markdown(file_path)
if save_path:
    # Reuse existing content - 50% faster!
    with open(save_path, "w") as f:
        f.write(content)

🌐 Browser Tools MCP (15+ Tools)

• Web navigation and interaction
• Screenshot and content extraction
• Form automation and submission

📊 Excel MCP Server (6+ Tools)

• Sheet reading and writing
• Formula and table creation
• Screen capture (Windows)

🎨 Benefits of This Collection

🌍 Universal Compatibility

• ✅ Works everywhere - any workspace, any directory
• ✅ No per-project setup required
• ✅ Consistent tool availability across all projects

⚡ Performance Optimized

• ✅ 50% faster PDF processing (fixed duplicate bug)
• ✅ Reliable server startup (fixed log level validation)
• ✅ Efficient API usage across all servers

🏗️ Production Ready

• ✅ Based on popular packages with proven track records
• ✅ Comprehensive error handling and logging
• ✅ Security best practices for token management

📚 Developer Friendly

• ✅ Complete documentation and setup guides
• ✅ Troubleshooting assistance for common issues
• ✅ Example configurations for popular MCP clients

📋 Prerequisites

• 🪟 Windows 10/11 (PowerShell 7+)
• 🐍 Python 3.10+ (for PyMuPDF4LLM MCP)
• 📦 Node.js 18+ (for Vercel, Browser, Excel MCPs)
• 🔑 API Tokens:
  • GitHub Personal Access Token (repo, read:user, notifications scopes)
  • Vercel API Token (full access)

🔧 Installation Options

🚀 Option 1: Quick Install (Recommended)

# Clone repository
git clone https://github.com/Mgabr90/universal-mcp-servers.git
cd universal-mcp-servers

# Run quick installer
.\scripts\setup\quick-install.ps1

📚 Option 2: Manual Setup

1. Follow individual guides in `docs/setup-guides/`

2. Copy configurations from `configs/`

3. Update paths and tokens

4. Test each server individually

🎯 Option 3: Custom Configuration

1. Use universal templates in `configs/`

2. Select only the servers you need

3. Customize settings for your workflow

🆘 Troubleshooting

Common Issues & Quick Fixes

📖 Detailed Solutions: See `docs/troubleshooting/COMMON_ISSUES.md`

🤝 Contributing

1. 🍴 Fork the repository

2. 🌿 Create a feature branch (`git checkout -b feature/amazing-feature`)

3. 💾 Commit your changes (`git commit -m 'Add amazing feature'`)

4. 📤 Push to the branch (`git push origin feature/amazing-feature`)

5. 🔄 Open a Pull Request

📄 License

MIT License - see LICENSE file for details.

Third-Party Acknowledgments

• PyMuPDF4LLM: Original by pymupdf/pymupdf4llm-mcp (modified for performance)
• Vercel MCP: nganiet/mcp-vercel
• Browser Tools: @agentdeskai/browser-tools-mcp
• Excel MCP: @negokaz/excel-mcp-server

🌟 What You Get

✅ 70+ Professional Tools ready for immediate use

✅ Performance Optimizations with measurable improvements

✅ Universal Compatibility across development environments

✅ Production-Grade Reliability for mission-critical workflows

✅ Comprehensive Documentation for quick onboarding

✅ Active Maintenance with ongoing improvements

🎯 Ready to Transform Your Workflow?

git clone https://github.com/Mgabr90/universal-mcp-servers.git
cd universal-mcp-servers
.\scripts\setup\quick-install.ps1

🚀 Your AI assistant will have universal access to:

• Complete GitHub workflow automation
• Lightning-fast PDF processing
• Seamless Vercel deployment management
• Advanced web browser control
• Powerful Excel data manipulation