This MCP server collection aggregates multiple specialized servers that provide weather data, web search, IP information, artifact registry management, UFC/MMA data, Wikipedia search, Yandex search, and general HTTP client utilities. Each server runs its own Python-based MCP endpoint and exposes its functionality on a dedicated port (8001–8008). To start a specific server, run the provided command in the repository root or ensure the server’s Python file path is correct, then visit the local URL shown in the server’s README (e.g., http://localhost:8001 for Weather). The collection uses the FastMCP framework, and you can interact with each server’s capabilities via typical MCP protocol calls, such as querying weather forecasts, performing web searches with filters, or retrieving IP geolocation data.

Prerequisites:

• Python 3.11+ installed on your system
• Git installed
• Access to the repository with all mcp-* folders present

Step-by-step installation:

1. Clone the repository: git clone https://github.com/your-username/simple_mcp_server.git cd simple_mcp_server

2. Install Python dependencies for each server (if pyproject.toml exists within subdirectories, you can install them per server):

   • For a quick setup, you can install dependencies in bulk if a requirements file exists in each server folder, otherwise rely on pyproject.toml with/without virtualenv as preferred.

3. Run a specific server (example for Weather): python mcp-weather/server.py

   Access: http://localhost:8001

4. Start all free servers (if a Makefile target is provided): make start-all make ports

5. Docker option (if available): cd mcp-weather && docker-compose up -d

Notes:

• The configuration ports are 8001–8008 for the eight servers listed. Adjust environment variables if your deployment requires keys or specific settings.
• If a server requires API keys (e.g., Cloud.ru Registry or Yandex), set the corresponding environment variables before starting the server.

Tips and common issues:

• Ensure Python 3.11+ is installed and that you’re running from the repository root so the relative paths to each server file (e.g., mcp-weather/server.py) resolve correctly.
• If a server fails to start, inspect the log output for missing dependencies or port conflicts. Use the provided PORT env var placeholders to customize ports if needed.
• For Cloud.ru Artifact Registry, export CLOUD_RU_KEY_ID and CLOUD_RU_SECRET before launching the server.
• The Makefile contains convenience targets (start-all, ports, list-services) to manage multiple servers together.
• If you’re behind a firewall or VPN, ensure outbound access for any external APIs used by the servers (weather, search, etc.).
• Regularly update submodules or folders to keep dependencies in sync with the FastMCP framework.