home / mcp / mcp weather & files ai server

MCP Weather & Files AI Server

Provides real-time weather data, local file access, geographic facts, and AI-driven analysis through MCP.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "gabriellsanabria-mcp-weather-server": {
      "command": "python",
      "args": [
        "C:/caminho/para/server.py"
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY",
        "WEATHER_API_KEY": "YOUR_WEATHER_API_KEY",
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY"
      }
    }
  }
}

You can run and interact with the MCP Weather & Files AI Server to fetch real-time weather data, securely read local files, explore directory structures, retrieve geographic facts, and receive AI-powered analyses. This MCP server is designed to work with compatible MCP clients to perform these tasks efficiently using asynchronous, high-performance operations.

How to use

To use this MCP server, connect your MCP client to the local server and choose one of the available tools to perform a task. The server exposes tools for weather data, file system access, geographic information, and AI-powered analysis. You can simulate tool calls, observe real-time logs, and validate connectivity to external APIs through the management dashboard or your MCP client.

How to install

Prerequisites: ensure Python 3.10 or newer is installed on your system.

1. Clone the repository and navigate into the project directory.

2. Create and activate a virtual environment.

3. Install dependencies from the requirements file.

Additional sections

Configuration and runtime details are provided to enable seamless integration with external services and AI providers.

Security considerations include read-only access to local files, path validations to prevent directory traversal, and strictly defined tool schemas.

Dashboard access lets you manage tools, view live logs, and test external API connectivity through a web interface.

Available tools

get_weather

Retrieves current weather conditions for a specified city and optional country code.

read_file

Safely reads text files from the local filesystem with read-only access.

list_directory

Lists contents of a local directory with file metadata.

get_location_facts

Provides demographic and geographic data for a given country.

analyze_with_ai

Performs complex analyses and generates recommendations using large language models with a defined default strategy.