# RTIdeas MCP API Server

Servidor API REST para RTIdeas con soporte MongoDB. Convierte tu MCP local en un servidor remoto accesible vía HTTP.

## 🚀 Inicio Rápido

### 1. Instalar Dependencias
```bash
pip install -r requirements.txt
```

### 2. Configurar Variables de Entorno
```bash
cp env.example .env
# Editar .env con tu MONGODB_URI
```

### 3. Iniciar Servidor
```bash
# Desarrollo (con auto-reload)
python dev_server.py

# Producción
python server.py
```

## 📁 Archivos Principales

- **`server.py`** - Archivo principal del servidor (para producción)
- **`dev_server.py`** - Servidor de desarrollo (con auto-reload)
- **`rtideas_api_server.py`** - Lógica principal del servidor API
- **`config.py`** - Configuración del servidor
- **`mongodb_connector.py`** - Conector a MongoDB
- **`requirements.txt`** - Dependencias Python
- **`env.example`** - Variables de entorno de ejemplo

## 🌐 URLs del Servidor

- **API**: http://localhost:8000
- **Documentación**: http://localhost:8000/docs
- **Health Check**: http://localhost:8000/health

## 📡 Endpoints Disponibles

### Herramientas MCP (POST)
```
POST /tools/list_sessions
POST /tools/get_session
POST /tools/list_ideas
POST /tools/search_ideas
POST /tools/get_idea_connections
POST /tools/get_idea_clusters
POST /tools/get_session_stats
POST /tools/analyze_session
POST /tools/hello_rtideas
```

### Recursos MCP (GET)
```
GET /resources/sessions
GET /resources/ideas/{session_id}
GET /resources/connections/{session_id}
GET /resources/clusters/{session_id}
GET /resources/stats/{session_id}
```

## 🚀 Despliegue en Servidor

### Opción 1: Docker (Recomendado)
```bash
# Crear docker-compose.yml
docker-compose up -d
```

### Opción 2: VPS/Cloud
```bash
# Instalar dependencias
pip install -r requirements.txt

# Configurar variables de entorno
cp env.example .env
nano .env

# Iniciar servidor
python server.py
```

### Opción 3: Con Gunicorn (Producción)
```bash
gunicorn rtideas_api_server:app -w 4 -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:8000
```

## 🔧 Variables de Entorno

| Variable | Descripción | Valor por Defecto |
|----------|-------------|-------------------|
| `MONGODB_URI` | URI de conexión MongoDB | Requerido |
| `MONGODB_DATABASE` | Nombre de la base de datos | `rtideas` |
| `API_HOST` | Host del servidor | `0.0.0.0` |
| `API_PORT` | Puerto del servidor | `8000` |
| `API_RELOAD` | Auto-reload en desarrollo | `false` |
| `CORS_ORIGINS` | Orígenes permitidos | `*` |

## 📊 Ejemplo de Uso

```bash
# Health check
curl http://localhost:8000/health

# Listar herramientas
curl http://localhost:8000/tools

# Usar herramienta
curl -X POST "http://localhost:8000/tools/hello_rtideas" \
     -H "Content-Type: application/json" \
     -d '{"name": "Usuario"}'
```

## 🔒 Seguridad

- Configurar `CORS_ORIGINS` en producción
- Usar HTTPS en producción
- Agregar autenticación si es necesario

## 📝 Logs y Monitoreo

```bash
# Ver logs del servidor
tail -f server.log

# Health check
curl http://localhost:8000/health
```

## 🆘 Troubleshooting

1. **Puerto en uso**: Cambiar `API_PORT` en `.env`
2. **MongoDB no conecta**: Verificar `MONGODB_URI`
3. **CORS errors**: Configurar `CORS_ORIGINS`

Para más detalles, ver `DEPLOYMENT.md`.