Unified MCP Suite

Una colección de servidores MCP para herramientas multimedia, recuperación de información, creación de PDF y generación de presentaciones.

GitHub

Documentación

Unified MCP Suite

Este repositorio contiene una colección de servidores de Protocolo de Contexto de Modelo (MCP), empaquetados juntos por conveniencia. Cada servidor proporciona funcionalidades distintas relacionadas con el manejo de medios, la recuperación de información y la creación de documentos.

📦 Ver Paquetes Publicados - ¡Guía de instalación fácil para todos los paquetes npm!

Importante: Estos servidores están diseñados para ejecutarse como procesos separados. Debe configurar y ajustar cada servidor individualmente dentro de su cliente MCP (por ejemplo, Cline o la aplicación de escritorio de Claude).

Servidores Incluidos

Servidor de Herramientas de Medios (media-tools-server): Proporciona herramientas para buscar imágenes (Unsplash) y videos (YouTube), descargar imágenes y comprender contenido de imágenes/videos (Google Gemini, Transcripciones de YouTube). (Node.js/TypeScript)
Servidor de Recuperación de Información (information-retrieval-server): Proporciona herramientas para realizar búsquedas web (Búsqueda Personalizada de Google) y rastrear páginas web. (Node.js/TypeScript)
Servidor Creador de PDF (pdf-creator-server): Proporciona una herramienta para generar documentos PDF a partir de contenido HTML usando Playwright y Pillow. (Python)
Servidor Creador de Presentaciones (presentation-creator-server): Proporciona herramientas para ensamblar presentaciones de PowerPoint a partir de contenido de diapositivas HTML y generar PDFs a partir de HTML. (Python)

Inicio Rápido (Recomendado)

La forma más fácil de usar estos servidores MCP es a través de paquetes npm. ¡No es necesario clonar ni compilar!

Paquetes Publicados

Todos los servidores TypeScript/Node.js están disponibles en npm:

information-retrieval-mcp-server: Búsqueda web y rastreo
media-tools-mcp-server: Búsqueda de imágenes/videos y comprensión de medios
presentation-creator-mcp-server: Crear presentaciones y PDFs a partir de HTML

Opciones de Instalación

Opción 1: Usando npx (Más Fácil - Sin Instalación Requerida)

Agregue a su configuración del cliente MCP (por ejemplo, claude_desktop_config.json):

Ubicación del archivo de configuración:

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"]
    }
  }
}

Claves de API Requeridas:

Servidor de Recuperación de Información:
- Clave de API de Búsqueda Personalizada de Google (Obténgala aquí)
- ID del Motor de Búsqueda Personalizada (Cree uno aquí)
Servidor de Herramientas de Medios:
- Clave de API de Unsplash (Obténgala aquí)
- Clave de API de Google Gemini (Obténgala aquí)
Servidor Creador de Presentaciones: No se requieren claves de API

Opción 2: Instalación Global de npm

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

Luego configure con solo el nombre del comando:

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

Configuración Avanzada (Compilar desde el Código Fuente)

Si prefiere compilar desde el código fuente o necesita modificar los servidores:

1. Clonar el Repositorio

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

2. Servidor de Herramientas de Medios (`media-tools-server`)

(Node.js/TypeScript)

a. Navegar al Directorio:

cd media-tools-server

b. Instalar Dependencias:

npm install

c. Compilar el Servidor:

npm run build

(Esto compila el código TypeScript a JavaScript en el directorio build.)

d. Obtener Claves de API:

Clave de API de Unsplash: Requerida para la búsqueda de imágenes. Cree una cuenta y registre una aplicación en https://unsplash.com/developers.
Clave de API de Google: Requerida para la búsqueda/comprensión de videos y la comprensión de imágenes.
- Habilite la "YouTube Data API v3" y la "Vertex AI API" (para Gemini) en su proyecto de Google Cloud Console: https://console.cloud.google.com/
- Cree una clave de API en "APIs y Servicios" -> "Credenciales". Restrinja la clave si es necesario.

e. Configurar el Cliente MCP:

Agregue la siguiente configuración al archivo de configuración de su cliente MCP (por ejemplo, cline_mcp_settings.json o claude_desktop_config.json). Reemplace los marcadores de posición con sus claves de API reales y la ruta absoluta correcta al archivo del 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. Navegar de Vuelta:

cd ..

3. Servidor de Recuperación de Información (`information-retrieval-server`)

(Node.js/TypeScript)

a. Navegar al Directorio:

cd information-retrieval-server

b. Instalar Dependencias:

npm install

c. Compilar el Servidor:

npm run build

d. Obtener Claves de API:

Búsqueda Personalizada de Google:
- Habilite la "Custom Search API" en su proyecto de Google Cloud Console: https://console.cloud.google.com/
- Cree una clave de API en "APIs y Servicios" -> "Credenciales".
- Cree un Motor de Búsqueda Personalizada y obtenga su ID: https://programmablesearchengine.google.com/

e. Configurar el Cliente MCP:

Agregue la siguiente configuración al archivo de configuración de su cliente MCP. Reemplace los marcadores de posición con su clave de API real, ID del Motor de Búsqueda y la ruta absoluta correcta.

{
  "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. Navegar de Vuelta:

cd ..

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

(Python)

a. Navegar al Directorio:

cd pdf-creator-server

b. Crear y Activar el Entorno 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. Instalar Dependencias:

pip install -r requirements.txt

d. Instalar Navegadores de Playwright: (Requerido para la generación de PDF)

playwright install

e. Configurar el Cliente MCP:

Agregue la siguiente configuración al archivo de configuración de su cliente MCP. Reemplace el marcador de posición con la ruta absoluta correcta al ejecutable de Python dentro del entorno virtual y al script del 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. Desactivar el Entorno Virtual (Opcional):

deactivate

g. Navegar de Vuelta:

cd ..

5. Servidor Creador de Presentaciones (`presentation-creator-server`)

(Python)

a. Navegar al Directorio:

cd presentation-creator-server

b. Crear y Activar el Entorno 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. Instalar Dependencias:

pip install -r requirements.txt

d. Instalar Navegadores de Playwright: (Requerido para capturar diapositivas HTML)

playwright install

e. Configurar el 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. Desactivar el Entorno Virtual (Opcional):

deactivate

g. Navegar de Vuelta:

cd ..

Ejecutar los Servidores

Una vez configurados en su cliente MCP, los servidores deberían iniciarse automáticamente cuando el cliente se lance. Luego puede usar las herramientas proporcionadas por cada servidor a través de la interfaz de su cliente MCP.

Archivo de Configuración de Ejemplo

Se incluye un archivo de configuración de ejemplo, example_cline_mcp_settings.json, en la raíz de este repositorio. Puede usarlo como plantilla para configurar los servidores en su cliente MCP (como Cline).

Para usar el ejemplo:

Localice el archivo de configuración real de su cliente MCP (por ejemplo, c:\Users\YourUser\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json para Cline en VS Code en Windows).
Copie las configuraciones del servidor de example_cline_mcp_settings.json a su archivo de configuración real, fusionándolas con cualquier configuración de servidor existente que pueda tener.
Crucialmente, actualice todas las rutas de marcador de posición (por ejemplo, C:/absolute/path/to/...) para reflejar la ruta absoluta real donde clonó el repositorio unified-mcp-suite en su sistema.
Reemplace todas las claves de API de marcador de posición (por ejemplo, YOUR_GOOGLE_API_KEY_HERE) con sus propias claves obtenidas durante los pasos de configuración.
Asegúrese de que la ruta command para los servidores Python apunte correctamente al ejecutable python.exe (Windows) o python (macOS/Linux) dentro del directorio .venv respectivo que creó.

Unified MCP Suite

Documentación

Unified MCP Suite

Servidores Incluidos

Inicio Rápido (Recomendado)

Paquetes Publicados

Opciones de Instalación

Opción 1: Usando npx (Más Fácil - Sin Instalación Requerida)

Opción 2: Instalación Global de npm

Configuración Avanzada (Compilar desde el Código Fuente)

1. Clonar el Repositorio

2. Servidor de Herramientas de Medios (media-tools-server)

3. Servidor de Recuperación de Información (information-retrieval-server)

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

5. Servidor Creador de Presentaciones (presentation-creator-server)

Ejecutar los Servidores

Archivo de Configuración de Ejemplo

2. Servidor de Herramientas de Medios (`media-tools-server`)

3. Servidor de Recuperación de Información (`information-retrieval-server`)

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

5. Servidor Creador de Presentaciones (`presentation-creator-server`)