MCP服务器

Name: MCP服务器
Author: cloud-ru

作者：cloud-ru3 星标更新：2025-06-25

安装使用来源：spider==github.com

项目介绍

🔧 MCP 服务器集合

一个用于各种任务的简单而强大的 MCP（模型上下文协议）服务器集合。大多数服务器完全免费运行，无需 API 密钥！ 🎉

🎯 可用服务器

服务器	端口	描述	API	状态
🌤️ 天气	8001	天气和预报	Open-Meteo	🆓 免费
🔍 搜索	8002	网络搜索、新闻、图片	DuckDuckGo	🆓 免费
🌐 IP 信息	8003	IP 地址信息	免费 API	🆓 免费
🏛️ 工件注册表	8004	Cloud.ru 工件注册表	Cloud.ru	🔑 需要密钥
🥊 UFC	8005	UFC 和 MMA 信息	UFC API	🆓 免费
📚 维基百科	8006	搜索维基百科	维基百科 API	🆓 免费
🔍 Yandex 搜索	8007	Yandex 搜索	Yandex API	🔑 需要密钥
📥 获取	8008	HTTP 请求和上传	-	🆓 免费

⚡ 快速开始

安装并运行所有免费服务器：

# 克隆仓库
git clone https://github.com/your-username/simple_mcp_server.git
cd simple_mcp_server

# 使用一条命令启动所有免费服务器
make start-all

# 检查状态
make ports

单独启动服务器：

# 例如，天气服务器
cd mcp-weather
uv sync
uv run python server.py

Docker 启动：

# 启动特定服务器
make weather-run-build

# 或者在服务器目录中使用 docker-compose
cd mcp-weather
docker-compose up -d

🌤️ 天气服务器 - 天气

功能：

🌍 世界各地城市的当前天气
📅 一周天气预报
🔄 不需要 API 密钥的真实数据 (Open-Meteo)
🌐 支持国际城市名称

cd mcp-weather && uv run python server.py
# 在 http://localhost:8001 上可用

🔍 搜索服务器 - 网络搜索

功能：

🌐 网络搜索（最多 50 条结果）
📰 带日期的新闻搜索
🖼️ 带尺寸的图片搜索
🎥 带时长的视频搜索
🌍 区域设置
⏰ 时间过滤器

cd mcp-search && uv run python server.py
# 在 http://localhost:8002 上可用

🌐 IP 服务器 - IP 信息

功能：

🌍 IP 地址的地理定位
🎯 详细信息（提供商、时区）
🤖 用户 IP 自动识别
🔄 支持 IPv4 和 IPv6
🛡️ API 之间的自动回退

cd mcp-ip && uv run python server.py
# 在 http://localhost:8003 上可用

📚 维基百科服务器 - 维基百科搜索

功能：

🔍 关键词文章搜索
📖 文章的简短和完整内容
🏗️ 文章部分结构
🔗 从文章中提取链接
🌐 支持 5 种语言（ru, en, de, fr, es）

cd mcp-wikipedia && uv run python server.py
# 在 http://localhost:8006 上可用

🥊 UFC 服务器 - UFC & MMA

功能：

🥊 战士信息和统计数据
📅 赛事日程
🏆 官方排名
📊 战斗结果
👑 冠军战斗历史

cd mcp-ufc && uv run python server.py
# 在 http://localhost:8005 上可用

🏛️ 工件注册表服务器 - Cloud.ru

功能：

📦 Docker/Debian/RPM 注册表管理
⚙️ 运营监控
🛡️ 安全管理
🔍 注册表的详细信息

需要设置：

export CLOUD_RU_KEY_ID="your_key_id_here"
export CLOUD_RU_SECRET="your_secret_here"
cd mcp-artifact-registry && uv run python server.py

🔍 Yandex 搜索服务器

功能：

🌐 通过 Yandex 搜索 API 搜索
📊 结构化结果
🔧 灵活的搜索设置

需要 Yandex API 密钥

📥 获取服务器 - HTTP 客户端

功能：

🌐 HTTP GET/POST 请求
📥 文件和内容上传
🔧 自定义头部
⚡ 异步请求

cd mcp-fetch && uv run python server.py
# 在 http://localhost:8008 上可用

🛠️ 技术

FastMCP 2.0 - Python 的 MCP 框架
Python 3.11+ 现代版 Python
uv 快速依赖管理
pytest - 全面测试
Docker - 容器化
httpx 异步 HTTP 客户端

📊 项目统计

8 个服务器 在集合中
6 个免费 服务器（不需要 API 密钥）
超过 35 个工具 可用
超过 120 个测试 全覆盖
Docker 支持 所有服务器
Makefile 团队方便

🐳 Docker 团队

# 管理所有服务
make start-all      # 启动所有免费服务器
make stop-all       # 停止所有服务器
make ports          # 显示使用的端口
make list-services  # 列出所有服务

# 单个服务器命令
make weather-run-build    # 天气服务器
make search-run-build     # 搜索服务器
make ip-run-build         # IP 服务器
make ufc-run-build        # UFC 服务器
make wikipedia-run-build  # 维基百科服务器
# ...等等

🧪 测试

每个服务器都包括完整的测试集：

# 测试特定服务器
cd mcp-weather
make test-all       # 所有测试
make test-unit      # 单元测试
make test-integration # 集成测试
make test-cov       # 带覆盖率的测试

# 演示测试
make test-demo      # 展示所有功能的工作

📁 项目结构

simple_mcp_server/
├── LICENSE                    # MIT 许可证
├── README.md                  # 此文件
├── Makefile                   # 管理命令
├── mcp-weather/              # 🌤️ 天气服务器
├── mcp-search/               # 🔍 搜索服务器
├── mcp-ip/                   # 🌐 IP 信息
├── mcp-artifact-registry/    # 🏛️ Cloud.ru 工件注册表
├── mcp-ufc/                  # 🥊 UFC 信息
├── mcp-wikipedia/            # 📚 维基百科搜索
├── mcp-yandex-search/        # 🔍 Yandex 搜索
└── mcp-fetch/                # 📥 HTTP 客户端

每个文件夹包含：

server.py - 主服务器
README.md - 详细文档
pyproject.toml - 依赖项
Dockerfile Docker 配置
test/ 测试
Makefile - 开发团队

🤝 项目贡献

我们欢迎任何改进！

Fork 项目
创建 特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
打开 拉取请求

贡献想法：

🆕 新 MCP 服务器
🐛 修复错误
📚 改进文档
🧪 添加测试
🌐 本地化
⚡ 生产力优化

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件以获取详情。

🎉 致谢

FastMCP 优秀的 MCP 框架
Open-Meteo - 免费天气 API
DuckDuckGo - 私人搜索
所有项目贡献者！

⭐ 喜欢这个项目吗？给个星吧！ ⭐