Skip to main content
Glama
automationagent10-max

RTIdeas MCP API Server

by automationagent10-max
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

pip install -r requirements.txt

2. Configurar Variables de Entorno

cp env.example .env
# Editar .env con tu MONGODB_URI

3. Iniciar Servidor

# 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

📡 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)

# Crear docker-compose.yml
docker-compose up -d

Opción 2: VPS/Cloud

# 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)

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

# 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

# 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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors