Sistema de Agentes MCP

Este projeto implementa um sistema de agentes usando o MCP (Model Completion Protocol) da Anthropic junto com o OpenAI Agents SDK.

Estrutura do Projeto

mymcp/
│
├── agents/                  # Pacote de agentes especializados
│   ├── __init__.py          # Inicialização e fallbacks para o pacote
│   ├── base_agent.py        # Classe base para agentes
│   ├── math_agent.py        # Agente especializado em matemática
│   └── weather_agent.py     # Agente especializado em clima
│
├── tools/                   # Pacote de ferramentas para os agentes
│   ├── __init__.py          # Inicialização do pacote
│   ├── math_tools.py        # Ferramentas matemáticas
│   └── weather_tools.py     # Ferramentas de clima
│
├── client.py                # Cliente de linha de comando
├── server.py                # Servidor MCP
├── mcp_manager.py           # Gerenciador de conexões MCP
├── mcp_instance.py          # Instância MCP compartilhada
├── llm_config.py            # Configuração de modelos LLM
└── orchestrator.py          # Orquestrador de agentes

Instalação

1. Crie um ambiente virtual:

   python -m venv .venv
   

2. Ative o ambiente virtual:

   • Windows: .venv\Scripts\activate
   • Linux/Mac: source .venv/bin/activate

3. Instale as dependências:

   pip install -r requirements.txt
   

4. Configure o arquivo .env com sua chave de API:

   OPENAI_API_KEY=sua_chave_aqui
   

Uso

1. Inicie o cliente:

   python client.py
   

2. Digite suas perguntas relacionadas a matemática ou clima.

   • O orquestrador direcionará sua pergunta para o agente especialista apropriado.

Teste Individual de Componentes

Para testar agentes individualmente:

python -m agents.math_agent
python -m agents.weather_agent
python -m orchestrator

Resolução de Problemas

• Erro de importação: Certifique-se de que todos os diretórios do projeto estão no caminho Python
• Erro de conexão MCP: Verifique se o servidor está rodando corretamente