AI导哈

MCP服务器集合

一个生产就绪的Model Context Protocol (MCP)服务器集合，包含性能优化、错误修复和通用配置，适用于GitHub管理、PDF处理、Vercel部署等多种场景。

  • by Mgabr90
  • PowerShell
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 mgabr90/universal-mcp-servers

使用说明

🌍 通用MCP服务器集合

一个全面的、可用于生产的模型上下文协议（MCP）服务器集合，具有性能优化、错误修复和通用配置。

🚀 包含什么

🎯 5台生产就绪的MCP服务器

服务器 工具 状态 主要功能
🐙 GitHub MCP 50+ ✅ 功能齐全 存储库管理、问题、PR、搜索、安全警报
🚀 Vercel MCP 11+ ✅ 生产就绪 部署、项目、环境变量、团队
📄 PyMuPDF4LLM MCP 1.✅ 性能已修复 PDF处理 速度提高50% 比原版
🌐 浏览器工具MCP 15+ ✅ 准备就绪 网络导航、屏幕截图、表单自动化
📊 Excel MCP 6.✅ 准备就绪 Excel操作、公式、屏幕截图

🔧 已应用性能修复

🚨 修复了PyMuPDF4LLM性能问题

  • 问题：PDF已处理 两次 使用时 save_path （2倍处理时间）
  • 解决方案：消除了重复 pymupdf4llm.to_markdown() 电话
  • 结果: 性能提高50% 用于文件操作
  • 附加修复：服务器启动日志级别验证错误已解决

📊 快速比较

演出前后对比

操作 原始 固定版本 改进
PDF直接内容 ⚡ 快速 ⚡ 快速 无变化
PDF文件保存 🐌 2x处理 ⚡ 1x处理 速度提高50%
大PDF（100+页） 🐌 非常慢 ⚡ 已优化 重要的
服务器启动 ❌ 失败 ✅ 可靠 固定的

🛠️ 快速开始

1.克隆和安装

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

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

2.配置您的客户端

🎯 光标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"]
    }
  }
}

💬 克劳德桌面：

  • 复制 configs/claude-desktop/claude_desktop_config.json
  • 更新路径并添加API令牌
  • 重新启动克劳德桌面

3.测试您的设置

"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"

🎯 实际使用示例

GitHub工作流自动化

🤖 "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处理管道

🤖 "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部署管理

🤖 "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数据分析

🤖 "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"

📁 存储库结构

📦 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

🔧 服务器详细信息

🐙 GitHub MCP服务器（50多种工具）

🎯 存储库管理：

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

📋 问题和公关工作流程：

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

🔍 搜索与发现：

  • search_code, search_issues, search_users, search_repositories

🔔 通知：

  • list_notifications, mark_all_notifications_read, dismiss_notification

🔒 安全：

  • list_code_scanning_alerts, list_secret_scanning_alerts

🚀 Vercel MCP服务器（11+工具）

📦 部署管理：

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

🏗️ 项目配置：

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

👥 团队管理：

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

📄 PyMuPDF4LLM MCP（性能固定）

⚡ PDF处理：

  • convert_pdf_to_markdown - 速度提高50% 比原版
  • 图像提取和参考
  • 大文件支持分块
  • 可靠的服务器启动

🔧 技术改进：

# ❌ 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)

🌐 浏览器工具MCP（15+工具）

  • Web导航和交互
  • 屏幕截图和内容提取
  • 表单自动化和提交

📊 Excel MCP服务器（6+工具）

  • 纸张阅读和书写
  • 公式和表格创建
  • 屏幕截图（Windows）

🎨 此系列的好处

🌍 通用兼容性

  • ✅ 适用于所有地方 -任何工作区、任何目录
  • ✅ 无每个项目设置 必需的
  • ✅ 一致的工具可用性 在所有项目中

⚡ 性能优化

  • ✅ PDF处理速度提高50% （修复重复错误）
  • ✅ 可靠的服务器启动 （固定日志级别验证）
  • ✅ 高效使用API 跨所有服务器

🏗️ 生产就绪

  • ✅ 基于热门套餐 有良好的业绩记录
  • ✅ 全面的错误处理 以及日志记录
  • ✅ 安全最佳实践 用于令牌管理

📚 开发者友好

  • ✅ 完整的文件 和设置指南
  • ✅ 故障排除帮助 常见问题
  • ✅ 示例配置 适用于流行的MCP客户端

📋 先决条件

  • 🪟 Windows 10/11 （PowerShell 7+）
  • 🐍 Python 3.10+ （适用于PyMuPDF4LLM MCP）
  • 📦 Node.js 18+ （适用于Vercel、浏览器、Excel MCP）
  • 🔑 API令牌:
    • GitHub个人访问令牌（repo，读作：用户，通知范围）
    • Vercel API代币（完全访问）

🔧 安装选项

🚀 选项1：快速安装（推荐）

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

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

📚 选项2：手动设置

  1. 遵循以下个人指南 docs/setup-guides/
  2. 从以下位置复制配置 configs/
  3. 更新路径和令牌
  4. 单独测试每台服务器

🎯 选项3：自定义配置

  1. 在中使用通用模板 configs/
  2. 仅选择您需要的服务器
  3. 为您的工作流程自定义设置

🆘 故障排除

常见问题和快速修复

问题 快速修复
🚨 PyMuPDF4LLM处理速度慢 ✅ 使用我们的固定版本
🔒 GitHub 403权限错误 更新令牌范围（仓库、通知）
🚫 服务器未启动 检查PATH和依赖关系
⚙️ 配置未加载 验证JSON，重新启动客户端
📂 路径错误 使用绝对路径，转义反斜线
📦 找不到NPX 安装Node.js

📖 详细解决方案：参见 docs/troubleshooting/COMMON_ISSUES.md

🤝 贡献

  1. 🍴 分叉 存储库
  2. 🌿 创建 特征分支(git checkout -b feature/amazing-feature)
  3. 💾 提交 您的更改(git commit -m 'Add amazing feature')
  4. 📤 推 到分行(git push origin feature/amazing-feature)
  5. 🔄 打开 拉取请求

📄 许可证

MIT许可证 -看 许可证 文件以获取详细信息。

第三方确认

🌟 所得

✅ 70+专业工具 准备立即使用
✅ 性能优化 有可衡量的改进
✅ 通用兼容性 跨开发环境
✅ 生产级可靠性 用于关键任务工作流
✅ 综合文档 快速入职
✅ 主动维护 持续改进

🎯 准备好改变你的工作流程了吗？

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

🚀 您的人工智能助手将可以普遍访问：

  • 完成GitHub工作流自动化
  • 闪电般快速的PDF处理
  • 无缝Vercel部署管理
  • 高级web浏览器控制
  • 强大的Excel数据操作

由以下材料制成❤️ 对于MCP社区

⭐ 标记此回购 • 📖 阅读文档 • 🐛 报告问题 • 💬 获得支持

相关 MCP