Claude Code MCP

Orquestra múltiplos agentes do Claude Code em sessões do iTerm2, fornecendo gerenciamento centralizado e comunicação entre agentes.

GitHub

Experimente este MCPPatrocinado

Documentação

Claude Code MCP - Plataforma de Orquestração de Agentes

Visão Geral

Um sofisticado servidor Python FastMCP que orquestra múltiplos agentes Claude Code em sessões iTerm2, fornecendo gerenciamento centralizado e comunicação entre agentes por meio de fluxos de trabalho baseados em tarefas.

Arquitetura

Plataforma de Orquestração de Agentes com:

Sessões Baseadas em Abas do iTerm2: Sem complexidade de janelas, gerenciamento puro de abas
Estado Persistente do Agente: Sobrevive a reinicializações do iTerm com recuperação de estado
Sessões Vinculadas a Codebases: Sessões associadas a caminhos de arquivo raiz específicos
Isolamento Máximo de Segurança: Separação em nível de processo entre agentes
Comunicação entre Agentes Baseada em Tarefas: Coordenação de fluxo de trabalho ADDER+
Injeção de Prompt do Sistema: Nomeação automática Agent_# e prefixação de prompts

Ferramentas MCP Principais

Ferramenta	Finalidade	Nível de Segurança
`create_agent`	Cria nova instância de agente Claude Code	ALTO
`delete_agent`	Remove agente do sistema	ALTO
`create_session`	Cria sessão vinculada ao caminho raiz do arquivo	MÉDIO
`get_session_status`	Retorna o status de todos os agentes na sessão	BAIXO
`delete_session`	Remove a sessão inteira e todos os agentes	ALTO
`send_message_to_agent`	Envia mensagem com prefixação ADDER+	MÉDIO
`clear_agent_conversation`	Fecha a aba atual do iTerm para o agente	MÉDIO
`start_new_agent_conversation`	Abre nova aba do iTerm para o agente	MÉDIO

Integração do Fluxo de Trabalho ADDER+

Cada agente opera com o protocolo abrangente ADDER+ (Desenvolvimento Avançado, Documentação e Resolução de Erros), permitindo:

Gerenciamento Autônomo de Tarefas: Execução orientada por TODO.md com acompanhamento de progresso em tempo real
Síntese Avançada de Programação: Design by Contract + programação defensiva + desenvolvimento orientado a tipos + testes baseados em propriedades + padrões de programação funcional
Resolução Sistemática de Erros: Análise de Causa Raiz com geração automática de tarefas
Coordenação entre Agentes: Comunicação baseada em tarefas por meio de arquivos de documentação

Modelo de Segurança

Isolamento de Processos: Cada agente Claude Code executa em processo separado
Limites de Sessão: Agentes não podem acessar codebases de outras sessões
Criptografia de Estado: Estado persistente do agente criptografado em repouso
Registro de Auditoria: Todas as interações dos agentes registradas para análise de segurança
Modelo de Permissões: Controle de acesso baseado em funções para operações de agentes

Início Rápido

# Install dependencies
uv sync

# Start the MCP server
python src/main.py

Configuração do Claude Desktop

Para usar esta Plataforma de Orquestração de Agentes com o Claude Desktop, você precisa configurá-la como um servidor MCP no arquivo de configuração do Claude.

Localização do Arquivo de Configuração

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%/Claude/claude_desktop_config.json

Etapas de Configuração

Abrir Arquivo de Configuração: Navegue até o local do arquivo de configuração acima. Crie o arquivo se ele não existir.
Adicionar Configuração do Servidor: Adicione a seguinte configuração ao seu claude_desktop_config.json:

Opção 1: Usando UV (Recomendado)

{
  "mcpServers": {
    "claude-code-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/Claude_Code_MCP",
        "run",
        "python",
        "src/main.py"
      ],
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src"
      }
    }
  }
}

Opção 2: Usando Python Diretamente

{
  "mcpServers": {
    "claude-code-mcp": {
      "command": "python",
      "args": [
        "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src/main.py"
      ],
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src"
      }
    }
  }
}

Opção 3: Usando Ambiente Virtual

{
  "mcpServers": {
    "claude-code-mcp": {
      "command": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/.venv/bin/python",
      "args": [
        "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src/main.py"
      ],
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src"
      }
    }
  }
}

Notas de Configuração

Substitua /ABSOLUTE/PATH/TO/Claude_Code_MCP pelo caminho absoluto real para o diretório do seu projeto
No Windows, use barras invertidas nos caminhos: C:\\path\ o\\Claude_Code_MCP
Nome do Servidor: Você pode alterar "claude-code-mcp" para qualquer nome de sua preferência
Ambiente Virtual: Se estiver usando um ambiente virtual, ajuste o caminho do Python de acordo

Opções Avançadas de Configuração

Com Nível de Segurança Personalizado

{
  "mcpServers": {
    "claude-code-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/Claude_Code_MCP",
        "run",
        "python",
        "src/main.py",
        "--security-level",
        "HIGH",
        "--max-agents",
        "16",
        "--max-sessions",
        "8"
      ],
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src"
      }
    }
  }
}

Com Diretório de Log Personalizado

{
  "mcpServers": {
    "claude-code-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/Claude_Code_MCP",
        "run",
        "python",
        "src/main.py",
        "--log-dir",
        "/ABSOLUTE/PATH/TO/Claude_Code_MCP/logs"
      ],
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src"
      }
    }
  }
}

Etapas de Verificação

Salvar Configuração: Salve o arquivo claude_desktop_config.json
Reiniciar o Claude Desktop: Saia completamente e reinicie o Claude Desktop
Verificar Status do MCP: Procure por indicadores do servidor MCP na interface do Claude Desktop:
- Ícone de martelo (🔨) indicando ferramentas disponíveis
- Ícone de conector indicando conexão com o servidor MCP
Testar Funcionalidade: Tente usar uma das ferramentas de orquestração de agentes

Solução de Problemas

Servidor Não Carregando

Verifique se todos os caminhos são absolutos (não relativos)
Confirme que uv ou python está no PATH do seu sistema
Garanta que o diretório do projeto exista e tenha as permissões corretas
Revise os logs do Claude Desktop em:
- macOS: ~/Library/Logs/Claude/mcp*.log
- Windows: %APPDATA%\Claude\logs\mcp*.log

Teste Manual

Teste o servidor manualmente antes de configurar o Claude Desktop:

# Navigate to project directory
cd /path/to/Claude_Code_MCP

# Test with UV
uv run python src/main.py --help

# Test with Python directly
python src/main.py --help

Problemas Comuns

Erros de Permissão: Garanta que o Claude Desktop tenha permissão para executar o interpretador Python
Erros de Importação: Verifique se PYTHONPATH está configurado corretamente na configuração
Conflitos de Porta: Se estiver usando transporte HTTP, garanta que a porta (padrão 8000) esteja disponível

Ferramentas MCP Disponíveis

Uma vez configurado, o Claude Desktop terá acesso a estas ferramentas de orquestração de agentes:

create_agent - Criar novas instâncias de agente Claude Code
delete_agent - Remover agentes do sistema
create_session - Criar sessões vinculadas a codebases específicos
get_session_status - Obter status de todos os agentes em uma sessão
delete_session - Remover sessões inteiras e todos os agentes
send_message_to_agent - Enviar mensagens com integração do protocolo ADDER+
clear_agent_conversation - Fechar aba atual do iTerm para o agente
start_new_agent_conversation - Abrir nova aba do iTerm para o agente

Fluxo de Trabalho de Desenvolvimento

Criação de Sessão: Vincule sessões a codebases específicos
Geração de Agentes: Crie agentes especializados com prompts de sistema personalizados
Coordenação de Tarefas: Agentes se comunicam por meio de TODO.md e arquivos de tarefas
Monitoramento de Status: Visibilidade em tempo real do progresso e saúde dos agentes
Gerenciamento de Sessão: Estado persistente com capacidades de recuperação

Pontos de Integração

Framework FastMCP: Implementação de servidor MCP de alto desempenho
API Python do iTerm2: Gerenciamento avançado de sessões de terminal
Claude Code: Orquestração de processos de agentes de IA
Arquitetura Asyncio: Gerenciamento concorrente de agentes orientado a eventos

Esta plataforma permite fluxos de trabalho sofisticados de desenvolvimento de IA com múltiplos agentes especializados trabalhando colaborativamente em codebases complexos, mantendo isolamento de segurança rigoroso e trilhas de auditoria abrangentes.