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
⚡ 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
| Componente | Mínimo | Recomendado |
|---|---|---|
| RAM | 4GB disponíveis | 8GB+ para desempenho ideal |
| Armazenamento | 500MB de espaço livre | 2GB+ para múltiplos caches de projetos |
| CPU | Qualquer processador moderno | Multi-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/
- macOS:
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
-
Clonar Repositório
git clone https://github.com/lutherscottgarcia/mcp-conductor.git cd mcp-conductor -
Instalar Dependências
npm install npm run build -
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" } } } } -
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étrica | Tradicional | Com MCP Conductor | Melhoria |
|---|---|---|---|
| Inicialização de Sessão | 15+ minutos | 10 segundos | Redução de 99,3% |
| Precisão de Contexto | Variável | 95%+ | Excelência consistente |
| Sobrecarga Mental | Alta | Zero | Eliminação de 100% |
| Experiência do Desenvolvedor | Frustrante | Encantadora | Mudanç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
- Guia de Incantações Mágicas - Padrões de copiar e colar para adoção instantânea
- Guia da Revolução da Eficiência - Guia completo de implementação
- API de Regras de Sessão - Referência completa da API para automação de fluxos de trabalho
- Referência da API - Documentação técnica
Aprofundamentos
- Estudo de Caso de Meta-Validação - Resultados comprovados com análise estatística
- Design Técnico - Especificações de arquitetura
🎯 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
- Faça um fork do repositório
- Crie um branch de funcionalidade:
git checkout -b feature/amazing-feature - Faça suas alterações
- Adicione testes para novas funcionalidades
- Execute a suíte de testes:
npm test - Faça commit das suas alterações:
git commit -m 'Add amazing feature' - Envie para o branch:
git push origin feature/amazing-feature - 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
- FAQ - Perguntas comuns e soluções
- Solução de Problemas - Corrija problemas comuns
- Melhores Práticas - Padrões de uso ideal
📄 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
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