MCP Servers - Model Context Protocol

Um conjunto abrangente de servidores MCP (Model Context Protocol) que fornecem integração com APIs externas e funcionalidades expandidas para assistentes de IA.

🎯 Visão Geral

Este projeto implementa servidores MCP especializados que permitem aos assistentes de IA interagir com serviços externos de forma segura e estruturada. Cada servidor é focado em uma funcionalidade específica, proporcionando modularidade e facilidade de manutenção.

Servidores Disponíveis

Servidor	Descrição	Status	Última Atualização
evoapi-mcp	Integração com Evolution API (WhatsApp)	✅ Ativo	2025-01-08
perplexity-mcp	Cliente para Perplexity AI API	✅ Ativo	2025-01-08

🚀 Início Rápido

Pré-requisitos

• Python 3.8 ou superior
• uv (recomendado) ou pip
• Git

Instalação

1. Clone o repositório:

   git clone <repository-url>
   cd MCP_SERVERS

2. Instale as dependências:

   # Para cada servidor, navegue até seu diretório
   cd evoapi-mcp
   uv sync
   cd ../perplexity-mcp
   uv sync

3. Configure as variáveis de ambiente:

   # Copie os arquivos de exemplo
   cp evoapi-mcp/.env.example evoapi-mcp/.env
   cp perplexity-mcp/.env.example perplexity-mcp/.env
   
   # Edite com suas credenciais

Configuração Rápida

Cada servidor possui configuração independente. Consulte os READMEs específicos:

• evoapi-mcp/README.md
• perplexity-mcp/README.md

📁 Estrutura do Projeto

MCP_SERVERS/
├── 📁 docs/                          # Documentação organizada
│   ├── 📁 guides/                    # Guias e tutoriais
│   ├── 📁 troubleshooting/           # Resolução de problemas
│   ├── 📁 reports/                   # Relatórios de testes
│   └── 📁 archives/                  # Documentos históricos
├── 📁 evoapi-mcp/                    # Servidor Evolution API
│   ├── 📁 src/                       # Código fonte
│   ├── 📁 tests/                     # Testes organizados
│   ├── 📁 docs/                      # Documentação específica
│   ├── 🐍 evoapi_mcp.py             # Servidor principal
│   ├── ⚙️ pyproject.toml            # Configuração do projeto
│   └── 📋 pytest.ini                # Configuração de testes
├── 📁 perplexity-mcp/               # Servidor Perplexity
│   ├── 📁 src/                       # Código fonte
│   ├── 📁 tests/                     # Testes organizados
│   ├── 🐍 run.py                     # Servidor principal
│   ├── ⚙️ pyproject.toml            # Configuração do projeto
│   └── 📋 pytest.ini                # Configuração de testes
├── 🔧 verify_test_structure.py      # Verificação da estrutura
├── 📄 README.md                     # Este arquivo
└── 🔒 .gitignore                    # Exclusões do Git

🛠️ Desenvolvimento

Executando os Servidores

Modo Individual

# Evolution API MCP Server
cd evoapi-mcp
uv run python evoapi_mcp.py

# Perplexity MCP Server  
cd perplexity-mcp
uv run python run.py

Modo Integrado (Claude Desktop)

Configure o claude_desktop_config.json:

{
  "mcpServers": {
    "evolution_api": {
      "command": "uv",
      "args": ["--directory", "C:/caminho/para/evoapi-mcp", "run", "python", "evoapi_mcp.py"],
      "env": {}
    },
    "perplexity-ask": {
      "command": "uv",
      "args": ["--directory", "C:/caminho/para/perplexity-mcp", "run", "python", "run.py"],
      "env": {}
    }
  }
}

Testes

Os testes são organizados em estrutura dedicada:

# Executar todos os testes
pytest evoapi-mcp/tests/ perplexity-mcp/tests/

# Executar testes específicos
pytest evoapi-mcp/tests/test_server.py

# Executar com cobertura
pytest --cov=src evoapi-mcp/tests/

# Verificar estrutura de testes
python verify_test_structure.py

Consulte docs/guides/TESTING_STRUCTURE.md para detalhes completos.

🔐 Segurança e Configuração

Variáveis de Ambiente

Cada servidor requer configurações específicas:

evoapi-mcp

EVOLUTION_API_URL=http://localhost:8080
EVOLUTION_API_TOKEN=your_token_here
EVOLUTION_INSTANCE=your_instance_name

perplexity-mcp

PERPLEXITY_API_KEY=your_api_key_here

Boas Práticas de Segurança

• ✅ Nunca commite arquivos .env
• ✅ Use tokens específicos por ambiente
• ✅ Implemente rotação regular de credenciais
• ✅ Monitore logs para atividade suspeita
• ✅ Use HTTPS em produção

📚 Documentação

Guias Principais

• 📖 Guia de Estrutura de Testes
• 🔧 Resolução de Problemas
• 📊 Relatórios de Teste

Documentação Específica dos Servidores

• Evolution API MCP
• Perplexity MCP

🧪 Status dos Testes

Componente	Status	Cobertura	Última Execução
evoapi-mcp	✅ Passando	85%	2025-01-08
perplexity-mcp	✅ Passando	78%	2025-01-08
Integração	✅ Passando	70%	2025-01-08

🤝 Contribuindo

1. Fork o projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add: AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

Padrões de Commit

• feat: - Nova funcionalidade
• fix: - Correção de bug
• docs: - Mudanças na documentação
• test: - Adição/modificação de testes
• refactor: - Refatoração de código

🐛 Resolução de Problemas

Problemas Comuns

1. Erro de conexão com APIs:

   • Verifique credenciais nas variáveis de ambiente
   • Confirme conectividade de rede
   • Consulte Troubleshooting Guide

2. Testes falhando:

   • Execute python verify_test_structure.py
   • Verifique dependências com uv sync

3. Claude Desktop não reconhece servidores:

   • Valide claude_desktop_config.json
   • Verifique caminhos absolutos
   • Reinicie Claude Desktop

📊 Métricas e Monitoramento

• Uptime: >99.5%
• Latência média: <200ms
• Taxa de erro: <0.1%

🗺️ Roadmap

2025 Q1

• Adicionar servidor MCP para Google APIs
• Implementar cache distribuído
• Melhorar cobertura de testes (>90%)

2025 Q2

• Interface web para monitoramento
• Métricas avançadas
• Documentação interativa

📄 Licença

Este projeto está licenciado sob a MIT License - veja o arquivo LICENSE para detalhes.

👥 Autores e Reconhecimentos

• Equipe de Desenvolvimento - Implementação inicial
• Comunidade MCP - Especificações e diretrizes
• Contribuidores - Melhorias e correções

📞 Suporte

• Issues: GitHub Issues
• Documentação: docs/
• Email: [suporte@projeto.com]

---

Nota: Este projeto está em desenvolvimento ativo. Consulte regularmente as atualizações e a documentação para as últimas funcionalidades e correções.

🔄 Changelog

[1.2.0] - 2025-01-08

• Reorganização completa da estrutura de testes
• Documentação abrangente implementada
• Sistema de segurança aprimorado

[1.1.0] - 2025-01-07

• Adicionado suporte ao Perplexity MCP
• Melhorias na estrutura do projeto

[1.0.0] - 2025-01-06

• Release inicial do Evolution API MCP
• Configuração básica do projeto