🚀 mcp-server-suite

mcp-server-suite 是一个全面的 MCP（模型上下文协议）服务器集合，致力于成为“自动化领域的 HuggingFace”。我们期望打造一个社区驱动的平台，让开发者既能使用现成的服务器，也能贡献自己的服务器，使自动化和 AI 驱动的工作流程人人可及。

✨ 主要特性

• MCP 核心：实现灵活的上下文管理
• 模块化架构：便于添加新工具和服务
• 不断增长的现成 MCP 服务器集合
• 与 API 和外部系统的轻松集成
• 通过 .env 文件支持环境变量
• 社区驱动的扩展和自定义

📦 安装指南

先决条件

• Python 3.13 或更高版本
• UV - 快速的 Python 包安装程序和解析器

安装步骤

1. 克隆仓库：

   git clone https://github.com/Dadiya-Harsh/mcp-server-suite.git
   cd mcp-server-suite
   

2. 如果尚未安装，安装 UV：

   pip install uv
   

3. 创建并激活虚拟环境：

   uv venv
   # 在 Windows 上：
   .venv\Scripts\activate
   # 在 Unix/macOS 上：
   source .venv/bin/activate
   

4. 使用 UV 安装依赖项：

   uv pip install -e .
   

5. 在 .env 文件中设置环境变量：

   # 对于 Web 搜索服务器
   TAVILY_API_KEY=your_api_key_here
   
   # 对于 PostgreSQL 服务器
   DATABASE_URI=postgresql://user:password@localhost:5432
   
   # 对于文件浏览器服务器
   ALLOWED_BASE_PATH=E:\Your\Safe\Path
   

💻 使用示例

运行服务器

每个服务器都可以独立运行：

# Web Search Server
python web_search/web_search_sse.py

# File Explorer Server
python file_explore/basic_file_server.py

# PostgreSQL 服务器（异步）
python database/postgresql/async_postgresql_server.py

作为用户使用平台

1. 安装包：

   uv pip install mcp-server-suite
   

2. 导入并使用任何服务器：

   from mcp_server_suite.web_search import web_search_server
   from mcp_server_suite.database import async_postgresql_server
   

📚 详细文档

现有服务器

核心服务器

• Web Search Server：使用 Tavily API 集成网络搜索功能
• File Explorer Server：安全的文件系统操作，带进度报告
• PostgreSQL 服务器：同步和异步数据库操作
• 更多功能即将推出！

计划中的 MCP 服务器

对于 AI/ML 工程师

• Dataset Explorer MCP：浏览/过滤来自 HuggingFace、Kaggle 等的数据集。
• Model Evaluation MCP：比较不同模型在任务或数据集上的性能。
• Experiment Tracker MCP：可视化来自 MLflow/W&B 的实验日志和指标。
• MCP 教育平台：提供在线教程和文档，帮助用户更好地理解和使用 MCP 技术。

对于开发人员

• Authentication Server MCP：实现基于令牌的身份验证机制，支持 OAuth2 和 OpenID Connect。
• Payment Processor MCP：集成多种支付网关（如 PayPal、Stripe），实现安全的交易处理。
• Notification Server MCP：通过 SMTP 或第三方服务（如 Twilio）发送电子邮件和 SMS 通知。

🤝 贡献

加入我们，共同塑造自动化领域的未来！欢迎贡献：

1. 叉取仓库
2. 创建你的功能分支
3. 添加你的服务器或改进
4. 提交拉取请求

有关更多详细信息，请参阅我们的 Contributing Guidelines。

🛠 支持

• Documentation
• Discord 社区
• GitHub Issues

📄 许可证

该项目根据 MIT License 许可。有关详细信息，请参阅 LICENSE 文件。