Phone-a-Friend MCP Server

Phone-a-Friend MCP Server 🧠📞

Um sistema de consulta entre IAs que permite que uma IA "ligue para um amigo" (outra IA) para pensamento crítico, raciocínio de contexto longo e resolução de problemas complexos via OpenRouter.

O Problema 🤔

Às vezes, uma IA encontra problemas complexos que exigem:

• Pensamento crítico profundo além das capacidades imediatas
• Raciocínio de contexto longo com informações extensas
• Análise em múltiplas etapas que se beneficia de uma perspectiva externa
• Experiência especializada de diferentes modelos de IA

A Solução

O Phone-a-Friend MCP Server cria um processo de consulta em duas etapas:

1. Contexto + Raciocínio: Empacote todo o contexto relevante e envie para a IA externa para análise profunda
2. Extrair Insights Acionáveis: Processe a resposta do raciocínio em um formato utilizável para a IA principal

Isso permite que sistemas de IA utilizem outros modelos de IA como "consultores" para tarefas complexas de raciocínio.

Arquitetura 🏗️

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

Fluxo de Trabalho Sequencial:

1. analyze_context - Reúna e estruture todo o contexto relevante
2. get_critical_thinking - Envie o contexto para a IA externa via OpenRouter para raciocínio
3. extract_actionable_insights - Processe a resposta em um formato acionável

Quando Usar 🎯

Ideal para:

• Problemas complexos de múltiplas etapas que exigem análise profunda
• Situações que precisam de raciocínio de contexto longo (>100k tokens)
• Consulta de especialização entre domínios
• Tomada de decisão crítica com alto risco
• Problemas que exigem múltiplas perspectivas

Início Rápido ⚡

Configure seu cliente MCP (ex.: Claude Desktop) usando o bloco JSON abaixo—não é necessário clonar ou instalar manualmente. O executor uv baixará e executará automaticamente o pacote do servidor se ele não estiver presente.

Adicione a seguinte configuração JSON ao seu cliente MCP e substitua <YOUR_API_KEY> pela sua chave:

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

Pronto! Agora você pode usar a ferramenta phone_a_friend em qualquer cliente compatível. Para mais opções, consulte a seção Configuração Avançada.

Ferramentas Disponíveis 🛠️

phone_a_friend

📞 Consulte a IA externa para pensamento crítico e raciocínio complexo. Faz chamadas de API para obter respostas.

fax_a_friend

📠 Gere arquivo de prompt mestre para consulta manual de IA. Cria arquivo para fluxo de trabalho de copiar e colar.

Parâmetros

phone_a_friend

• all_related_context (obrigatório): Contexto geral, não relacionado a código, como restrições, tracebacks ou requisitos de alto nível.
• file_list (obrigatório): Matriz de caminhos de arquivo ou padrões glob. Basta passar os caminhos – o servidor lê automaticamente esses arquivos (ignora qualquer coisa em .gitignore ou não-texto/binário) e constrói o contexto completo do código para a IA externa.
• task (obrigatório): Uma descrição clara e específica do que você deseja que a IA externa faça.

fax_a_friend

• all_related_context (obrigatório): Igual ao acima.
• file_list (obrigatório): Igual ao acima.
• task (obrigatório): Igual ao acima.
• output_directory (obrigatório): Diretório onde o arquivo de prompt mestre fax_a_friend.md gerado será salvo.

Configuração Avançada 🔧

Esta seção cobre todas as opções de configuração, incluindo variáveis de ambiente, flags de CLI e seleção de modelo.

Provedores e Chaves de API

O servidor pode ser configurado via flags de CLI ou variáveis de ambiente.

Provedor	Flag de CLI	Variável de Ambiente
OpenAI	--provider openai	OPENAI_API_KEY
OpenRouter	--provider openrouter	OPENROUTER_API_KEY
Anthropic	--provider anthropic	ANTHROPIC_API_KEY
Google	--provider google	GOOGLE_API_KEY

Exemplo de CLI:

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

Exemplo de Variável de Ambiente:

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

Seleção de Modelo

Você pode substituir o modelo padrão de cada provedor.

Provedor	Modelo Padrão
OpenAI	o3
Anthropic	Claude 4 Opus
Google	Gemini 2.5 Pro Preview 05-06
OpenRouter	anthropic/claude-4-opus

Substituir com CLI:

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

Substituir com Variável de Ambiente:

export PHONE_A_FRIEND_MODEL="o3"

Opções Adicionais

Recurso	Flag de CLI	Variável de Ambiente	Padrão
Temperatura	--temperature 0.5	PHONE_A_FRIEND_TEMPERATURE	0.4
URL Base	--base-url ...	PHONE_A_FRIEND_BASE_URL	Padrão do provedor

Casos de Uso 🎯

1. Raciocínio aprofundado para Vibe Coding
2. Para algoritmos complexos, estruturas de dados ou cálculos matemáticos
3. Desenvolvimento Frontend com React, Vue, CSS ou frameworks frontend modernos

Licença 📄

Licença MIT - consulte o arquivo LICENSE para detalhes.