MCP Conductor

Um servidor MCP avançado para gerenciamento inteligente de contexto de conversação e continuidade de sessão, exigindo o aplicativo Claude Desktop e um ambiente Node.js.

Documentação

MCP Conductor 🎭

Sistema Revolucionário de Orquestração com 5 MCPs
Elimina a sobrecarga de inicialização de sessões de IA com 99,3% de economia de tempo

MIT License Node.js TypeScript

⚡ A Revolução da Eficiência

Antes do MCP Conductor: Toda sessão de IA começa com 15+ minutos de exploração dolorosa do projeto
Depois do MCP Conductor: Carregamento instantâneo do contexto do projeto em 10 segundos

Resultado: 99,3% de economia de tempo, continuidade perfeita de contexto, experiência de desenvolvedor revolucionária

🎯 O que é o MCP Conductor?

O MCP Conductor é o primeiro sistema de orquestração com 5 MCPs do mundo que elimina a sobrecarga de inicialização de sessões por meio de cache inteligente de projetos. Ele coordena Memory MCP, Claudepoint MCP, Filesystem MCP, Git MCP e Database MCPs para fornecer continuidade perfeita de conversas.

🧠 Cache de Inteligência de Projeto - O Diferencial

Nosso revolucionário Cache de Inteligência de Projeto captura a compreensão completa do projeto uma vez e a carrega instantaneamente em sessões futuras:

# Traditional session (15+ minutes)
Session Start → Project Exploration → Architecture Understanding → Ready for Work

# MCP Conductor (10 seconds)  
Session Start → Load Cache → Immediate Full Context → Instant Productive Work

📋 Requisitos e Pré-requisitos

Requisitos do Sistema

Sistema Operacional

  • macOS 10.15+ (Catalina ou mais recente) ✅ Totalmente suportado
  • Linux Ubuntu 18.04+ / CentOS 8+ / Debian 10+ ⚠️ Suporte experimental
  • Windows 10/11 com WSL2 🚧 Em breve

Dependências Principais

  • Node.js 18.0.0 ou superior (Download)
  • npm 8.0.0 ou superior (incluído com Node.js)
  • Claude Desktop aplicativo (Download)
# Quick dependency check
node --version    # Should show v18.0.0+
npm --version     # Should show 8.0.0+

Dependências MCP (Instaladas automaticamente)

  • Memory MCP - @modelcontextprotocol/server-memory
  • Filesystem MCP - @modelcontextprotocol/server-filesystem

Requisitos de Hardware

ComponenteMínimoRecomendado
RAM4GB disponíveis8GB+ para desempenho ideal
Armazenamento500MB de espaço livre2GB+ para múltiplos caches de projetos
CPUQualquer processador modernoMulti-core para builds mais rápidos

Configuração do Ambiente

Detecção de Diretório de Projeto

O MCP Conductor detecta automaticamente diretórios de desenvolvimento comuns:

  • ~/RiderProjects/ (IDEs JetBrains)
  • ~/Projects/ (Genérico)
  • ~/Developer/ (Xcode)
  • ~/Code/ (VS Code)
  • ~/Development/, ~/workspace/, ~/src/

Permissões Necessárias

  • Acesso de Leitura/Escrita aos seus diretórios de projeto
  • Acesso de Leitura/Escrita à configuração do Claude:
    • macOS: ~/Library/Application Support/Claude/

Lista de Verificação Pré-Instalação

  • Node.js 18+ instalado e acessível
  • Claude Desktop instalado e com login realizado
  • Conexão com a internet para downloads de dependências
  • Acesso ao terminal com permissões apropriadas
  • Diretório do projeto identificado ou pronto para criar

Validação Rápida do Ambiente

# Comprehensive environment check (recommended)
curl -fsSL https://raw.githubusercontent.com/lutherscottgarcia/mcp-conductor/main/scripts/check-requirements.sh | bash

# Manual validation
node --version | grep -E "v(1[8-9]|[2-9][0-9])" && echo "✅ Node.js OK" || echo "❌ Needs upgrade"
npm --version | grep -E "^[8-9]|^[1-9][0-9]" && echo "✅ npm OK" || echo "❌ Needs upgrade"
ls "/Applications/Claude.app" && echo "✅ Claude Desktop found" || echo "❌ Install required"

🚀 Início Rápido

Instalação com Um Comando

curl -fsSL https://raw.githubusercontent.com/lutherscottgarcia/mcp-conductor/main/install.sh | bash

Instalação Manual

  1. Clonar Repositório

    git clone https://github.com/lutherscottgarcia/mcp-conductor.git
    cd mcp-conductor
    
  2. Instalar Dependências

    npm install
    npm run build
    
  3. Configurar Claude Desktop

    Adicione ao seu claude_desktop_config.json:

    {
      "mcpServers": {
        "conversation-continuity": {
          "command": "node",
          "args": ["/path/to/mcp-conductor/dist/index.js"],
          "env": {
            "MCP_CONDUCTOR_PROJECT_DIR": "/Users/YourName/Projects",
            "MCP_CONDUCTOR_WORKSPACE": "/Users/YourName/Projects/claude"
          }
        }
      }
    }
    
  4. Reiniciar Claude Desktop

🎭 Incantações Mágicas

Experimente a revolucionária economia de 99,3% de tempo que está mudando a forma como desenvolvedores trabalham com IA. Junte-se à missão para construir mais ferramentas inovadoras que amplificam o potencial humano.

Uso Básico

# Create project intelligence cache
create_project_intelligence_cache

# Load instant context (the magic!)
Load ProjectIntelligence_MyProject from Memory MCP - instant context!

Padrões Avançados

# Task-specific loading
Load ProjectIntelligence_MyProject from Memory MCP - continuing feature development!

# With your workflow rules
Load ProjectIntelligence_MyProject from Memory MCP - instant context! **YOUR RULES**: 1) Approval Required 2) Artifact Display

# Team coordination
Load ProjectIntelligence_TeamProject from Memory MCP - taking over payment integration from Sarah!

# Emergency response
Load ProjectIntelligence_ProductionApp from Memory MCP - URGENT production issue investigation!

📊 Resultados Comprovados

Sucesso na Meta-Validação

Testamos o MCP Conductor em seu próprio desenvolvimento:

MétricaTradicionalCom MCP ConductorMelhoria
Inicialização de Sessão15+ minutos10 segundosRedução de 99,3%
Precisão de ContextoVariável95%+Excelência consistente
Sobrecarga MentalAltaZeroEliminação de 100%
Experiência do DesenvolvedorFrustranteEncantadoraMudança de paradigma

Impacto no Mundo Real

// Before: Every session
const traditionalSession = {
  explorationTime: "15+ minutes",
  contextLoss: "frequent", 
  productivity: "delayed",
  frustration: "high"
};

// After: MCP Conductor
const revolutionizedSession = {
  loadingTime: "10 seconds",
  contextLoss: "eliminated",
  productivity: "immediate", 
  satisfaction: "revolutionary"
};

🏗️ Arquitetura

Orquestração com 5 MCPs

  • Memory MCP: Armazenamento persistente de inteligência
  • Claudepoint MCP: Coordenação de checkpoints
  • Filesystem MCP: Análise do sistema de arquivos
  • Git MCP: Integração com repositórios
  • Database MCPs: Dados de análise e plataforma

Cache de Inteligência de Projeto

  • Inteligência Estrutural: Análise do sistema de arquivos, caminhos críticos
  • Inteligência de Arquitetura: Fase atual, stack tecnológico
  • Inteligência de Desenvolvimento: Foco recente, próximos passos
  • Inteligência de Contexto: Propósito do projeto, metas, cronograma

🛠️ Recursos Principais

⚡ Revolução da Eficiência

  • Redução de 99,3% no tempo de inicialização de sessão
  • Cache inteligente de projetos com validação de atualização
  • Gatilhos inteligentes de invalidação para gerenciamento de cache
  • Atualizações incrementais para projetos alterados

🎭 Orquestração com 5 MCPs

  • Pacotes unificados de transferência entre múltiplos MCPs
  • Sincronização entre MCPs e monitoramento de saúde
  • Checkpoints coordenados para gerenciamento confiável de estado
  • Monitoramento inteligente de conversas e compressão

📋 Mecanismo de Regras de Sessão

  • As 5 Regras de Luther integradas para fluxo de trabalho ideal
  • Criação de regras personalizadas com aplicação flexível
  • Fluxos de aprovação para desenvolvimento seguro
  • Armazenamento persistente de regras entre sessões

🧠 Inteligência de Projeto

  • Análise abrangente de projetos com 30+ pontos de dados
  • Detecção de arquitetura e mapeamento de tecnologia
  • Avaliação de momentum de desenvolvimento
  • Recomendação dos próximos passos lógicos

📚 Documentação

Referências Rápidas

Aprofundamentos

🎯 Casos de Uso

Desenvolvimento Diário

# Morning startup
Load ProjectIntelligence_MyProject from Memory MCP - starting daily development session!

# Bug investigation  
Load ProjectIntelligence_MyProject from Memory MCP - investigating timeout errors in payment processing!

# Feature development
Load ProjectIntelligence_MyProject from Memory MCP - implementing user authentication with OAuth!

Coordenação de Equipe

# Taking over work
Load ProjectIntelligence_TeamProject from Memory MCP - taking over user dashboard from Mike!

# Code review
Load ProjectIntelligence_TeamProject from Memory MCP - reviewing Alex's database optimization PR!

# New team member onboarding
Load ProjectIntelligence_TeamProject from Memory MCP - onboarding new developer to codebase!

Resposta a Emergências

# Production issues
Load ProjectIntelligence_ProductionApp from Memory MCP - URGENT production outage investigation!

# Security incidents
Load ProjectIntelligence_MyProject from Memory MCP - SECURITY INCIDENT response and mitigation!

🔧 Configuração

Variáveis de Ambiente

# Project directory (auto-detected)
MCP_CONDUCTOR_PROJECT_DIR="/Users/YourName/Projects"

# Claude workspace (auto-detected)  
MCP_CONDUCTOR_WORKSPACE="/Users/YourName/Projects/claude"

# Test mode (for development)
MCP_TEST_MODE="true"

Configuração Avançada

{
  "mcpServers": {
    "conversation-continuity": {
      "command": "node",
      "args": ["/path/to/dist/index.js"],
      "env": {
        "MCP_CONDUCTOR_PROJECT_DIR": "/Users/YourName/Projects",
        "MCP_CONDUCTOR_WORKSPACE": "/Users/YourName/Projects/claude",
        "LOG_LEVEL": "info"
      }
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    },
    "filesystem": {
      "command": "npx", 
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/YourName/Projects"]
    }
  }
}

🧪 Desenvolvimento

Desenvolvimento Local

# Clone repository
git clone https://github.com/lutherscottgarcia/mcp-conductor.git
cd mcp-conductor

# Install dependencies
npm install

# Development server (with test mode)
npm run dev

# Build for production
npm run build

# Run tests
npm test

Testes

# Unit tests
npm run test

# Integration tests  
npm run test:integration

# Test coverage
npm run test:coverage

🤝 Contribuições

Aceitamos contribuições! Consulte nosso Guia de Contribuição para detalhes.

Configuração de Desenvolvimento

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade: git checkout -b feature/amazing-feature
  3. Faça suas alterações
  4. Adicione testes para novas funcionalidades
  5. Execute a suíte de testes: npm test
  6. Faça commit das suas alterações: git commit -m 'Add amazing feature'
  7. Envie para o branch: git push origin feature/amazing-feature
  8. Abra um Pull Request

📋 Roadmap

Fase 1: Eficiência Principal (✅ Concluída)

  • Sistema de Cache de Inteligência de Projeto
  • Orquestração com 5 MCPs
  • Mecanismo de Regras de Sessão
  • Padrões de incantação mágica

Fase 2: Integração Aprimorada (🚧 Em Andamento)

  • Integração avançada com Git
  • Recursos de colaboração em tempo real
  • Análises e insights aprimorados
  • Otimização de desempenho

Fase 3: Recursos Empresariais (📋 Planejado)

  • Gerenciamento de equipe e permissões
  • Integração com SSO empresarial
  • Monitoramento e alertas avançados
  • Orquestração multi-projeto

🌍 Comunidade e Suporte

Junte-se à Revolução

O MCP Conductor é mais que uma ferramenta - é a prova de que a IA pode genuinamente amplificar o potencial humano. Junte-se a uma comunidade de desenvolvedores, criadores e inovadores que acreditam em construir tecnologia que serve à humanidade.

💫 Apoie a Missão - Ajude a financiar produtos de IA inovadores que ampliam a criatividade humana
🎭 Discussões no GitHub - Compartilhe ideias e conecte-se com colegas revolucionários
🐛 Issues no GitHub - Reporte bugs e solicite recursos
💬 Comunidade Discord - Colaboração em tempo real (em breve)

Ao apoiar este trabalho, você está investindo em um futuro onde a IA realmente amplifica o potencial humano em vez de substituí-lo.

Documentação e Ajuda

📄 Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

🙏 Agradecimentos

Apoiadores da Missão

Esta revolução é impulsionada por uma comunidade que acredita que a IA deve ampliar o potencial humano:

  • Apoiadores do Patreon - Co-revolucionários financiando produtos de IA inovadores que servem à humanidade
  • Adotantes Iniciais - Desenvolvedores corajosos que validaram a revolução da eficiência
  • Colaboradores - Heróis do código aberto que melhoram o código
  • Membros da Comunidade - Inovadores compartilhando ideias e expandindo limites

Fundação Tecnológica

  • Anthropic pelo Claude e o revolucionário protocolo MCP
  • A Comunidade MCP por construir as ferramentas fundamentais que orquestramos
  • Ecossistema de Código Aberto pelas incríveis ferramentas de desenvolvimento que tornam isso possível

Cada apoiador, colaborador e membro da comunidade está ajudando a provar que a tecnologia pode genuinamente ampliar a criatividade e o potencial humano. Obrigado por acreditar na missão.

🌟 Histórico de Estrelas

Star History Chart


Transforme seu fluxo de trabalho de desenvolvimento de IA hoje. Junte-se à revolução da eficiência. 🚀

🎭 Experimente o MCP Conductor | 💫 Apoie a Missão | ✨ Incantações Mágicas

Status: ✅ Pronto para Produção | Impacto: 99,3% de Economia de Tempo | Adoção: Revolucionária