Unified MCP Suite

Uma coleção de servidores MCP para ferramentas de mídia, recuperação de informações, criação de PDF e geração de apresentações.

GitHub

Documentação

Unified MCP Suite

Este repositório contém uma coleção de servidores Model Context Protocol (MCP), empacotados juntos para conveniência. Cada servidor fornece funcionalidades distintas relacionadas a manipulação de mídia, recuperação de informações e criação de documentos.

📦 Ver Pacotes Publicados - Guia de instalação fácil para todos os pacotes npm!

Importante: Esses servidores são projetados para rodar como processos separados. Você precisa configurar e ajustar cada servidor individualmente dentro do seu cliente MCP (ex.: Cline ou o Claude Desktop App).

Servidores Incluídos

Servidor de Ferramentas de Mídia (media-tools-server): Fornece ferramentas para buscar imagens (Unsplash) e vídeos (YouTube), baixar imagens e entender conteúdo de imagem/vídeo (Google Gemini, YouTube Transcripts). (Node.js/TypeScript)
Servidor de Recuperação de Informações (information-retrieval-server): Fornece ferramentas para realizar buscas na web (Google Custom Search) e rastrear páginas da web. (Node.js/TypeScript)
Servidor Criador de PDF (pdf-creator-server): Fornece uma ferramenta para gerar documentos PDF a partir de conteúdo HTML usando Playwright e Pillow. (Python)
Servidor Criador de Apresentações (presentation-creator-server): Fornece ferramentas para montar apresentações PowerPoint a partir de conteúdo de slides HTML e gerar PDFs a partir de HTML. (Python)

Início Rápido (Recomendado)

A maneira mais fácil de usar esses servidores MCP é através dos pacotes npm. Não é necessário clonar ou compilar!

Pacotes Publicados

Todos os servidores TypeScript/Node.js estão disponíveis no npm:

information-retrieval-mcp-server: Busca na web e rastreamento
media-tools-mcp-server: Busca de imagem/vídeo e compreensão de mídia
presentation-creator-mcp-server: Crie apresentações e PDFs a partir de HTML

Opções de Instalação

Opção 1: Usando npx (Mais Fácil - Sem Instalação Necessária)

Adicione ao seu arquivo de configuração do cliente MCP (ex.: claude_desktop_config.json):

Localização do arquivo de configuração:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "information-retrieval": {
      "command": "npx",
      "args": ["-y", "information-retrieval-mcp-server"],
      "env": {
        "GOOGLE_API_KEY": "your-google-api-key",
        "GOOGLE_CSE_ID": "your-custom-search-engine-id"
      }
    },
    "media-tools": {
      "command": "npx",
      "args": ["-y", "media-tools-mcp-server"],
      "env": {
        "UNSPLASH_ACCESS_KEY": "your-unsplash-key",
        "GEMINI_API_KEY": "your-gemini-key"
      }
    },
    "presentation-creator": {
      "command": "npx",
      "args": ["-y", "presentation-creator-mcp-server"]
    }
  }
}

Chaves de API Necessárias:

Servidor de Recuperação de Informações:
- Chave da API Google Custom Search (Obtenha aqui)
- ID do Custom Search Engine (Crie um aqui)
Servidor de Ferramentas de Mídia:
- Chave da API Unsplash (Obtenha aqui)
- Chave da API Google Gemini (Obtenha aqui)
Servidor Criador de Apresentações: Nenhuma chave de API necessária

Opção 2: Instalação Global via npm

npm install -g information-retrieval-mcp-server
npm install -g media-tools-mcp-server
npm install -g presentation-creator-mcp-server

Depois configure apenas com o nome do comando:

{
  "mcpServers": {
    "information-retrieval": {
      "command": "information-retrieval-mcp-server",
      "env": { /* ... */ }
    }
  }
}

Configuração Avançada (Compilar a partir do Código Fonte)

Se você preferir compilar a partir do código fonte ou precisar modificar os servidores:

1. Clonar o Repositório

git clone <repository-url> # Replace <repository-url> with the actual URL
cd unified-mcp-suite

2. Servidor de Ferramentas de Mídia (`media-tools-server`)

(Node.js/TypeScript)

a. Navegue até o Diretório:

cd media-tools-server

b. Instale as Dependências:

npm install

c. Compile o Servidor:

npm run build

(Isso compila o código TypeScript em JavaScript no diretório build.)

d. Obtenha as Chaves de API:

Chave da API Unsplash: Necessária para busca de imagens. Crie uma conta e registre um aplicativo em https://unsplash.com/developers.
Chave da API Google: Necessária para busca/compreensão de vídeos e compreensão de imagens.
- Ative a "YouTube Data API v3" e a "Vertex AI API" (para Gemini) no seu projeto do Google Cloud Console: https://console.cloud.google.com/
- Crie uma chave de API em "APIs & Services" -> "Credentials". Restrinja a chave se necessário.

e. Configure o Cliente MCP:

Adicione a seguinte configuração ao arquivo de configurações do seu cliente MCP (ex.: cline_mcp_settings.json ou claude_desktop_config.json). Substitua os placeholders pelas suas chaves de API reais e pelo caminho absoluto correto para o arquivo do servidor compilado.

{
  "mcpServers": {
    // ... other servers
    "media-tools": {
      "command": "node",
      "args": ["C:/path/to/unified-mcp-suite/media-tools-server/build/index.js"], // <-- UPDATE THIS PATH
      "env": {
        "UNSPLASH_ACCESS_KEY": "YOUR_UNSPLASH_API_KEY", // <-- ADD YOUR KEY
        "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY"       // <-- ADD YOUR KEY
      },
      "disabled": false, // Set to false to enable
      "autoApprove": []
    }
    // ... other servers
  }
}

f. Navegue de Volta:

cd ..

3. Servidor de Recuperação de Informações (`information-retrieval-server`)

(Node.js/TypeScript)

a. Navegue até o Diretório:

cd information-retrieval-server

b. Instale as Dependências:

npm install

c. Compile o Servidor:

npm run build

d. Obtenha as Chaves de API:

Google Custom Search API:
- Ative a "Custom Search API" no seu projeto do Google Cloud Console: https://console.cloud.google.com/
- Crie uma chave de API em "APIs & Services" -> "Credentials".
- Crie um Custom Search Engine e obtenha seu ID: https://programmablesearchengine.google.com/

e. Configure o Cliente MCP:

Adicione a seguinte configuração ao arquivo de configurações do seu cliente MCP. Substitua os placeholders pela sua chave de API real, ID do Search Engine e o caminho absoluto correto.

{
  "mcpServers": {
    // ... other servers
    "information-retrieval": {
      "command": "node",
      "args": ["C:/path/to/unified-mcp-suite/information-retrieval-server/build/index.js"], // <-- UPDATE THIS PATH
      "env": {
        "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY",             // <-- ADD YOUR KEY
        "GOOGLE_CSE_ID": "YOUR_CUSTOM_SEARCH_ENGINE_ID"  // <-- ADD YOUR ID
      },
      "disabled": false, // Set to false to enable
      "autoApprove": []
    }
    // ... other servers
  }
}

f. Navegue de Volta:

cd ..

4. Servidor Criador de PDF (`pdf-creator-server`)

(Python)

a. Navegue até o Diretório:

cd pdf-creator-server

b. Crie e Ative o Ambiente Virtual:

# Create environment
python -m venv .venv

# Activate environment
# Windows (Command Prompt/PowerShell)
.\.venv\Scripts\activate
# macOS/Linux (bash/zsh)
# source .venv/bin/activate

c. Instale as Dependências:

pip install -r requirements.txt

d. Instale os Navegadores Playwright: (Necessário para geração de PDF)

playwright install

e. Configure o Cliente MCP:

Adicione a seguinte configuração ao arquivo de configurações do seu cliente MCP. Substitua o placeholder pelo caminho absoluto correto para o executável Python dentro do ambiente virtual e o script do servidor.

{
  "mcpServers": {
    // ... other servers
    "pdf-creator": {
      // UPDATE python path to point to the .venv executable
      "command": "C:/path/to/unified-mcp-suite/pdf-creator-server/.venv/Scripts/python.exe", // Windows example
      // "command": "/path/to/unified-mcp-suite/pdf-creator-server/.venv/bin/python", // macOS/Linux example
      "args": ["C:/path/to/unified-mcp-suite/pdf-creator-server/pdf_creator_server.py"], // <-- UPDATE THIS PATH
      "env": {}, // No specific environment variables needed by default
      "disabled": false, // Set to false to enable
      "autoApprove": []
    }
    // ... other servers
  }
}

f. Desative o Ambiente Virtual (Opcional):

deactivate

g. Navegue de Volta:

cd ..

5. Servidor Criador de Apresentações (`presentation-creator-server`)

(Python)

a. Navegue até o Diretório:

cd presentation-creator-server

b. Crie e Ative o Ambiente Virtual:

# Create environment
python -m venv .venv

# Activate environment
# Windows (Command Prompt/PowerShell)
.\.venv\Scripts\activate
# macOS/Linux (bash/zsh)
# source .venv/bin/activate

c. Instale as Dependências:

pip install -r requirements.txt

d. Instale os Navegadores Playwright: (Necessário para capturar slides HTML)

playwright install

e. Configure o Cliente MCP:

{
  "mcpServers": {
    // ... other servers
    "presentation-creator": {
      // UPDATE python path to point to the .venv executable
      "command": "C:/path/to/unified-mcp-suite/presentation-creator-server/.venv/Scripts/python.exe", // Windows example
      // "command": "/path/to/unified-mcp-suite/presentation-creator-server/.venv/bin/python", // macOS/Linux example
      "args": ["C:/path/to/unified-mcp-suite/presentation-creator-server/presentation_creator_server.py"], // <-- UPDATE THIS PATH
      "env": {}, // No specific environment variables needed by default
      "disabled": false, // Set to false to enable
      "autoApprove": []
    }
    // ... other servers
  }
}

f. Desative o Ambiente Virtual (Opcional):

deactivate

g. Navegue de Volta:

cd ..

Executando os Servidores

Uma vez configurados no seu cliente MCP, os servidores devem iniciar automaticamente quando o cliente for aberto. Você pode então usar as ferramentas fornecidas por cada servidor através da interface do seu cliente MCP.

Exemplo de Arquivo de Configuração

Um exemplo de arquivo de configuração, example_cline_mcp_settings.json, está incluído na raiz deste repositório. Você pode usá-lo como modelo para configurar os servidores no seu cliente MCP (como o Cline).

Para usar o exemplo:

Localize o arquivo de configurações real do seu cliente MCP (ex.: c:\Users\YourUser\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json para Cline no VS Code no Windows).
Copie as configurações dos servidores de example_cline_mcp_settings.json para o seu arquivo de configurações real, mesclando-as com quaisquer configurações de servidor existentes que você possa ter.
Crucialmente, atualize todos os caminhos placeholder (ex.: C:/absolute/path/to/...) para refletir o caminho absoluto real onde você clonou o repositório unified-mcp-suite no seu sistema.
Substitua todas as chaves de API placeholder (ex.: YOUR_GOOGLE_API_KEY_HERE) pelas suas próprias chaves obtidas durante as etapas de configuração.
Certifique-se de que o caminho command para os servidores Python aponte corretamente para o executável python.exe (Windows) ou python (macOS/Linux) dentro do respectivo diretório .venv que você criou.

Unified MCP Suite

Documentação

Unified MCP Suite

Servidores Incluídos

Início Rápido (Recomendado)

Pacotes Publicados

Opções de Instalação

Opção 1: Usando npx (Mais Fácil - Sem Instalação Necessária)

Opção 2: Instalação Global via npm

Configuração Avançada (Compilar a partir do Código Fonte)

1. Clonar o Repositório

2. Servidor de Ferramentas de Mídia (media-tools-server)

3. Servidor de Recuperação de Informações (information-retrieval-server)

4. Servidor Criador de PDF (pdf-creator-server)

5. Servidor Criador de Apresentações (presentation-creator-server)

Executando os Servidores

Exemplo de Arquivo de Configuração

2. Servidor de Ferramentas de Mídia (`media-tools-server`)

3. Servidor de Recuperação de Informações (`information-retrieval-server`)

4. Servidor Criador de PDF (`pdf-creator-server`)

5. Servidor Criador de Apresentações (`presentation-creator-server`)