Phone-a-Friend MCP Server

Servidor MCP Phone-a-Friend 🧠📞

Un sistema de consulta de IA a IA que permite a una IA "llamar a un amigo" (otra IA) para pensamiento crítico, razonamiento de contexto largo y resolución de problemas complejos a través de OpenRouter.

El Problema 🤔

A veces una IA se encuentra con problemas complejos que requieren:

• Pensamiento crítico profundo más allá de las capacidades inmediatas
• Razonamiento de contexto largo con información extensa
• Análisis de múltiples pasos que se beneficia de una perspectiva externa
• Experiencia especializada de diferentes modelos de IA

La Solución 💡

El Servidor MCP Phone-a-Friend crea un proceso de consulta de dos pasos:

1. Contexto + Razonamiento: Empaqueta todo el contexto relevante y envíalo a una IA externa para un análisis profundo
2. Extraer Información Accionable: Procesa la respuesta de razonamiento en un formato utilizable para la IA principal

Esto permite que los sistemas de IA aprovechen otros modelos de IA como "consultores" para tareas de razonamiento complejo.

Arquitectura 🏗️

Primary AI → Phone-a-Friend MCP → OpenRouter → External AI (O3, Claude, etc.) → Processed Response → Primary AI

Flujo de Trabajo Secuencial:

1. analyze_context - Recopilar y estructurar todo el contexto relevante
2. get_critical_thinking - Enviar contexto a la IA externa a través de OpenRouter para razonamiento
3. extract_actionable_insights - Procesar la respuesta en un formato accionable

Cuándo Usarlo 🎯

Ideal para:

• Problemas complejos de múltiples pasos que requieren análisis profundo
• Situaciones que necesitan razonamiento de contexto largo (>100k tokens)
• Consulta de experiencia entre dominios
• Toma de decisiones críticas con alto riesgo
• Problemas que requieren múltiples perspectivas

Inicio Rápido ⚡

Configura tu cliente MCP (por ejemplo, Claude Desktop) usando el bloque JSON a continuación—no se requiere clonación ni instalación manual. El ejecutor uv descargará y ejecutará automáticamente el paquete del servidor si no está presente.

Agrega la siguiente configuración JSON a tu cliente MCP y reemplaza <YOUR_API_KEY> con tu clave:

{
  "mcpServers": {
    "phone-a-friend": {
      "command": "uvx",
      "args": [
        "phone-a-friend-mcp-server",
        "--provider", "openai",
        "--api-key", "<YOUR_API_KEY>"
      ]
    }
  }
}

¡Eso es todo! Ahora puedes usar la herramienta phone_a_friend en cualquier cliente compatible. Para más opciones, consulta la sección de Configuración Avanzada.

Herramientas Disponibles 🛠️

phone_a_friend

📞 Consulta a una IA externa para pensamiento crítico y razonamiento complejo. Realiza llamadas API para obtener respuestas.

fax_a_friend

📠 Genera un archivo de prompt maestro para consulta manual de IA. Crea un archivo para el flujo de trabajo de copiar y pegar.

Parámetros

phone_a_friend

• all_related_context (obligatorio): Contexto general, no relacionado con código, como restricciones, tracebacks o requisitos de alto nivel.
• file_list (obligatorio): Matriz de rutas de archivo o patrones glob. Solo pasa las rutas – el servidor lee automáticamente esos archivos (omite cualquier cosa en .gitignore o archivos no textuales/binarios) y construye el contexto de código completo para la IA externa.
• task (obligatorio): Una descripción clara y específica de lo que quieres que haga la IA externa.

fax_a_friend

• all_related_context (obligatorio): Igual que arriba.
• file_list (obligatorio): Igual que arriba.
• task (obligatorio): Igual que arriba.
• output_directory (obligatorio): Directorio donde se guardará el archivo de prompt maestro fax_a_friend.md generado.

Configuración Avanzada 🔧

Esta sección cubre todas las opciones de configuración, incluyendo variables de entorno, banderas CLI y selección de modelos.

Proveedores y Claves API

El servidor se puede configurar mediante banderas CLI o variables de entorno.

Proveedor	Banderas CLI	Variable de Entorno
OpenAI	--provider openai	OPENAI_API_KEY
OpenRouter	--provider openrouter	OPENROUTER_API_KEY
Anthropic	--provider anthropic	ANTHROPIC_API_KEY
Google	--provider google	GOOGLE_API_KEY

Ejemplo CLI:

phone-a-friend-mcp-server --provider openai --api-key "sk-..."

Ejemplo de Variable de Entorno:

export OPENAI_API_KEY="sk-..."
phone-a-friend-mcp-server

Selección de Modelo

Puedes anular el modelo predeterminado para cada proveedor.

Proveedor	Modelo Predeterminado
OpenAI	o3
Anthropic	Claude 4 Opus
Google	Gemini 2.5 Pro Preview 05-06
OpenRouter	anthropic/claude-4-opus

Anular con CLI:

phone-a-friend-mcp-server --model "o3"

Anular con Variable de Entorno:

export PHONE_A_FRIEND_MODEL="o3"

Opciones Adicionales

Característica	Banderas CLI	Variable de Entorno	Predeterminado
Temperatura	--temperature 0.5	PHONE_A_FRIEND_TEMPERATURE	0.4
URL Base	--base-url ...	PHONE_A_FRIEND_BASE_URL	Predeterminado del proveedor

Casos de Uso 🎯

1. Razonamiento profundo para Vibe Coding
2. Para algoritmos complejos, estructuras de datos o cálculos matemáticos
3. Desarrollo Frontend con React, Vue, CSS o frameworks frontend modernos

Licencia 📄

Licencia MIT - consulta el archivo LICENSE para más detalles.