# Local MCP Test Server

Servidor MCP (Model Context Protocol) de pruebas locales que expone herramientas meteorológicas mediante transporte SSE, compatible con dispositivos móviles (iOS/Android).

## Características

- **Transporte SSE** para conexión desde apps móviles en red local
- **API Open-Meteo** (gratuita, sin API key)
- **FastMCP** para registro automático de herramientas
- **Compatible con Qwen 2.5** y otros LLMs

## Stack Tecnológico

| Componente | Tecnología |
|------------|------------|
| Lenguaje | Python 3.11+ |
| Framework MCP | mcp[cli] + FastMCP |
| Cliente HTTP | httpx (async) |
| Servidor ASGI | uvicorn + starlette |

## Requisitos

- Python 3.11+
- pip o uv

## Instalación

```bash
# Clonar repositorio
git clone https://github.com/cserra16/local-mcp-test-server.git
cd local-mcp-test-server

# Crear entorno virtual
python3 -m venv venv
source venv/bin/activate

# Instalar dependencias
pip install -r requirements.txt
```

## Ejecución

```bash
source venv/bin/activate
python app.py
```

El servidor iniciará en `http://0.0.0.0:8000` con transporte SSE.

## Endpoints MCP

| Método | Ruta | Descripción |
|--------|------|-------------|
| GET | `/sse` | Handshake SSE (obtiene session_id) |
| POST | `/messages/?session_id=...` | Mensajes JSON-RPC |

## Herramientas Disponibles

### `get_weather_lhospitalet`

Obtiene el clima actual de L'Hospitalet de Llobregat (Barcelona).

**Triggers:** El LLM invocará esta herramienta cuando el usuario pregunte por el clima en:
- L'Hospitalet de Llobregat
- Hospitalet
- Hospi
- L'Hospi
- L'H

**Retorna:** Temperatura (°C), humedad relativa (%) y estado del cielo.

**Ejemplo de respuesta:**
```
Clima en L'Hospitalet de Llobregat: 18.5°C, Humedad: 65%, Estado del cielo: Parcialmente nublado. Datos provistos por Open-Meteo.
```

## Pruebas

### Con MCP Inspector (recomendado)

```bash
npx -y @modelcontextprotocol/inspector http://localhost:8000/sse
```

### Test con Python

```python
import asyncio
from mcp import ClientSession
from mcp.client.sse import sse_client

async def test():
    async with sse_client('http://localhost:8000/sse') as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            result = await session.call_tool('get_weather_lhospitalet', {})
            print(result.content[0].text)

asyncio.run(test())
```

### Desde el navegador

Acceder a `http://localhost:8000/sse` para verificar eventos SSE.

## Conexión desde iOS

1. Asegúrate de que el iPhone esté en la misma red Wi-Fi
2. Obtén la IP local: `ipconfig getifaddr en0`
3. Conecta desde la app iOS a `http://<IP-LOCAL>:8000/sse`

## Estructura del Proyecto

```
local-mcp-test-server/
├── app.py              # Servidor MCP principal
├── requirements.txt    # Dependencias
├── pyproject.toml      # Configuración del proyecto
└── README.md
```

## Licencia

MIT