AI导哈

AI助手协议服务器

MCP Servers是一组实现AI助手与外部API安全集成的模块化协议服务器，支持WhatsApp和Perplexity AI等服务集成。

  • by ecodelearn
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ecodelearn/mcp_servers

使用说明

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:

📁 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

Documentação Específica dos Servidores

🧪 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

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

相关 MCP