Weather Alerts

Ejemplo de servidor MCP para principiantes

Resumen del proyecto

Es una aplicación de Python que proporciona alertas meteorológicas en tiempo real para los estados de EE. UU. utilizando la API del Servicio Meteorológico Nacional (NWS). Aprovecha el framework mcp (con FastMCP) y está diseñado para flujos de trabajo modernos de Python asíncrono. El proyecto se gestiona completamente con uv para la gestión de dependencias y la ejecución de tareas.

---

Características

• Herramienta de alertas meteorológicas: Obtiene y formatea alertas meteorológicas activas para cualquier estado de EE. UU.
• Recurso Echo: Endpoint simple de eco para pruebas.
• Asíncrono y moderno: Utiliza Python 3.12+ y patrones async/await.
• Inspector MCP: Herramienta visual para inspeccionar y probar tus herramientas y recursos MCP.

---

Estructura del proyecto

.
├── main.py                # Simple entry point (prints a message)
├── pyproject.toml         # Project metadata and dependencies
├── uv.lock                # Locked dependencies for reproducible installs
├── server/
│   └── weather.py         # Main server logic and weather tool/resource
├── .venv/                 # (optional) Virtual environment
├── .python-version        # Python version pin (3.12)
├── .gitignore             # Standard Python ignores
└── README.md              # Project documentation

---

Requisitos previos

• Python 3.12+
• uv (instalar con pip install uv si aún no está instalado)

---

Configuración e instalación

1. Clonar el repositorio:

   git clone <your-repo-url>
   cd mcpproject
   

2. Instalar las dependencias usando uv:

   uv pip install -r uv.lock
   

   O, si deseas instalar desde pyproject.toml:

   uv pip install
   

---

Ejecución del proyecto

1. Ejecutar el script principal

Para ejecutar el punto de entrada básico:

uv run python main.py

2. Desarrollar y probar la herramienta meteorológica

Para iniciar el servidor de desarrollo MCP para la herramienta meteorológica:

uv run mcp dev server/weather.py

Esto también abrirá el Inspector MCP en tu navegador: una herramienta visual para explorar y probar tus herramientas y recursos MCP de forma interactiva.

3. Instalar la herramienta meteorológica

Para instalar la herramienta meteorológica y usarla como herramienta MCP:

uv run mcp install server/weather.py

---

Ejemplo de uso

Con el servidor de desarrollo en ejecución, puedes usar el Inspector MCP o un cliente compatible con MCP para llamar a la herramienta get_alerts:

• Nombre de la herramienta: get_alerts
• Argumento: Código de estado de EE. UU. de dos letras (por ejemplo, CA, NY)

Ejemplo (desde la CLI):

mcp call get_alerts --state=CA

Uso con Claude Desktop

También puedes usar la herramienta de alertas meteorológicas en Claude Desktop, como se muestra a continuación:

Alertas meteorológicas para California mostradas en Claude Desktop usando la herramienta get_alerts.

Configuración de Claude Desktop

Para llamar a este servidor MCP desde Claude Desktop, debes actualizar tu archivo claude_desktop_config.json para incluir el servidor. Por ejemplo:

{
  {
  "mcpServers": {
    "weather": {
      "command": "C:\\Users\\shubhechhadey\\.local\\bin\\uv.EXE",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "C:\\Users\\shubhechhadey\\projects\\mcpproject\\server\\weather.py"
      ]
    }
  }
}
}

Se adjunta la captura de pantalla:

---

Notas

• Todos los comandos usan uv