# OHIP MCP Server

Un servidor MCP (Model Context Protocol) en Python que actúa como **Gateway Universal** para la plataforma Oracle Hospitality Interface Platform (OHIP). Permite a asistentes de IA ejecutar cualquier petición contra la API de OHIP de forma segura y autenticada.

## 🚀 Características

- **Herramienta Universal (`call_ohip_api`)**: Una única herramienta flexible capaz de ejecutar cualquier endpoint de OHIP (reservas, inventario, housekeeping, etc.).
- **Autenticación Automática**: Gestión transparente de tokens OAuth 2.0 (obtención, almacenamiento en memoria y renovación automática antes de expirar).
- **Seguridad**: Manejo seguro de credenciales mediante variables de entorno.
- **Ligero**: Construido con `mcp` y `httpx` para alto rendimiento asíncrono.

## 📋 Requisitos

- Python 3.10+
- Una cuenta de desarrollador en Oracle Hospitality (OHIP) con credenciales válidas.
- [uv](https://github.com/astral-sh/uv) (Recomendado para gestión de paquetes) o `pip`.

## 🛠️ Instalación

1. **Clonar el repositorio**
   ```bash
   git clone https://github.com/tu-usuario/ohip-mcp.git
   cd ohip-mcp
   ```

2. **Configurar entorno**
   Copia el archivo de ejemplo y configura tus credenciales:
   ```bash
   cp .env.example .env
   ```
   Edita `.env` con tus datos de OHIP:
   ```env
   OHIP_BASE_URL=https://<environment>.oraclecloud.com
   OHIP_CLIENT_ID=tu_client_id
   OHIP_CLIENT_SECRET=tu_client_secret
   OHIP_APP_KEY=tu_app_key
   ```

3. **Instalar dependencias**
   ```bash
   # Usando pip
   pip install -r requirements.txt
   
   # O usando uv (más rápido)
   uv sync
   ```

## ⚙️ Configuración en Clientes MCP

### Claude Desktop

Edita tu configuración en `%APPDATA%\Claude\claude_desktop_config.json` (Windows) o `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):

```json
{
  "mcpServers": {
    "ohip": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:/Ruta/Absoluta/A/ohip-mcp",
        "python",
        "-m",
        "src.server"
      ],
      "env": {
        "OHIP_BASE_URL": "https://...",
        "OHIP_CLIENT_ID": "...",
        "OHIP_CLIENT_SECRET": "...",
        "OHIP_APP_KEY": "..."
      }
    }
  }
}
```

### Cursor / TRAE IDE

Puedes añadir el servidor directamente en la configuración del proyecto (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "ohip": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "C:/Ruta/Absoluta/A/ohip-mcp",
      "env": { "DOTENV_PATH": "../.env" }
    }
  }
}
```

## 📖 Uso

Una vez conectado, el asistente tendrá acceso a la herramienta `call_ohip_api`.

**Ejemplo de Prompt:**
> "Busca las reservas del hotel con ID 'H123' para el huésped 'Smith'."

El modelo llamará internamente a:
```python
call_ohip_api(
    method="GET",
    endpoint="/rsv/v1/hotels/H123/reservations",
    hotel_id="H123",
    query_params={"lastName": "Smith"}
)
```

## 📂 Estructura del Proyecto

```
ohip-mcp/
├── src/
│   ├── auth.py         # Manejo de autenticación OAuth (Singleton)
│   └── server.py       # Definición del servidor y herramientas MCP
├── .env.example        # Plantilla de variables de entorno
├── .gitignore          # Archivos ignorados por git
├── mcp.example.json    # Ejemplos de configuración para IDEs
├── requirements.txt    # Dependencias del proyecto
└── README.md           # Documentación
```

## 🛡️ Licencia

Este proyecto está bajo la Licencia MIT.