Zoom Transcript

Servidor MCP de Transcripciones de Zoom

Un servidor MCP (Protocolo de Contexto de Modelos) para interactuar con las transcripciones de grabaciones en la nube de Zoom. Este servidor te permite listar, descargar, buscar y gestionar las transcripciones de tus reuniones de Zoom a través de una interfaz estructurada.

Características

• Listar reuniones: Ver todas las reuniones de Zoom disponibles con grabaciones
• Descargar transcripciones: Descargar transcripciones de reuniones específicas por ID o UUID
• Obtener transcripciones recientes: Descargar automáticamente transcripciones de reuniones recientes
• Buscar transcripciones: Buscar en todas las transcripciones descargadas contenido específico
• Almacenamiento organizado: Las transcripciones se almacenan en un sistema de archivos estructurado por mes

Requisitos previos

• Node.js (v16 o superior)
• Cuenta de Zoom con grabación en la nube habilitada
• Credenciales de la aplicación OAuth de Zoom (ID de cuenta, ID de cliente, Secreto de cliente)

Instalación

1. Clona este repositorio:

   git clone https://github.com/yourusername/zoom_transcript_mcp.git
   cd zoom_transcript_mcp
   

2. Instala las dependencias:

   npm install
   

3. Compila el proyecto:

   npm run build
   

Configuración

Crea un archivo .env en el directorio raíz con las siguientes variables:

ZOOM_ACCOUNT_ID=your_zoom_account_id
ZOOM_CLIENT_ID=your_zoom_client_id
ZOOM_CLIENT_SECRET=your_zoom_client_secret
TRANSCRIPTS_DIR=/path/to/transcripts/directory  # Optional, defaults to ./transcripts

Alternativamente, puedes configurar el servidor a través de tu archivo de configuración de MCP:

{
  "mcpServers": {
    "zoom-transcripts": {
      "command": "node",
      "args": ["/path/to/zoom-transcripts-server/build/index.js"],
      "env": {
        "ZOOM_ACCOUNT_ID": "your_zoom_account_id",
        "ZOOM_CLIENT_ID": "your_zoom_client_id",
        "ZOOM_CLIENT_SECRET": "your_zoom_client_secret",
        "TRANSCRIPTS_DIR": "/path/to/transcripts/directory"  // Optional
      }
    }
  }
}

Obtención de credenciales de Zoom

1. Ve al Mercado de aplicaciones de Zoom e inicia sesión
2. Haz clic en "Desarrollar" > "Crear aplicación"
3. Elige el tipo de aplicación "OAuth de servidor a servidor"
4. Completa la información requerida
5. En "Ámbitos", agrega los siguientes permisos:
   • cloud_recording:read:list_account_recordings:admin
   • cloud_recording:read:recording:admin
   • cloud_recording:read:list_user_recordings:admin
6. Guarda y activa tu aplicación
7. Anota tu ID de cuenta, ID de cliente y Secreto de cliente

Uso

Herramientas disponibles

1. list_meetings

Lista las reuniones de Zoom disponibles con grabaciones.

{
  "dateRange": {
    "from": "2025-01-01",
    "to": "2025-03-31"
  },
  "participant": "John Doe"  // Optional
}

2. download_transcript

Descarga una transcripción para una reunión específica.

{
  "meetingId": "123456789"  // Meeting ID or UUID
}

3. get_recent_transcripts

Descarga transcripciones de reuniones recientes.

{
  "count": 5  // Number of recent meetings to fetch (default: 5)
}

4. search_transcripts

Busca en las transcripciones descargadas contenido específico.

{
  "query": "AI discussion",
  "dateRange": {  // Optional
    "from": "2025-01-01",
    "to": "2025-03-31"
  }
}

Ejemplo de uso con Claude

<use_mcp_tool>
<server_name>zoom-transcripts</server_name>
<tool_name>search_transcripts</tool_name>
<arguments>
{
  "query": "project timeline"
}
</arguments>
</use_mcp_tool>

Almacenamiento de transcripciones

Las transcripciones se almacenan en la siguiente estructura:

transcripts/
├── YYYY-MM/
│   ├── YYYY-MM-DD_HH-MM-SS_Meeting-Topic_MeetingID.vtt
│   └── metadata/
│       └── YYYY-MM-DD_HH-MM-SS_Meeting-Topic_MeetingID.json

Cada transcripción tiene un archivo JSON de metadatos correspondiente que contiene:

• ID y UUID de la reunión
• Tema
• Hora de inicio y duración
• Participantes (extraídos de la transcripción)
• Ruta del archivo de la transcripción

Desarrollo

Estructura del proyecto

zoom_transcript_mcp/
├── src/
│   └── index.ts
├── package.json
├── tsconfig.json
├── .gitignore
├── README.md
└── .env.example

Compilación

npm run build

Ejecución local

node build/index.js

Licencia

MIT