Servidor MCP de transcripciones de Zoom

Un servidor MCP (Protocolo de Contexto de Modelo) para interactuar con las transcripciones de Zoom Cloud Recording. Este servidor permite listar, descargar, buscar y administrar las transcripciones de las reuniones de Zoom mediante una interfaz estructurada.

Características

• Lista de reuniones : ver todas las reuniones de Zoom disponibles con grabaciones

• Descargar transcripciones : descargue transcripciones de reuniones específicas por ID o UUID

• Obtener transcripciones recientes : descargue automáticamente las transcripciones de reuniones recientes

• Buscar transcripciones : busque contenido específico en todas las transcripciones descargadas

• Almacenamiento organizado : las transcripciones se almacenan en un sistema de archivos estructurado por mes.

Related MCP server: Cal.com Calendar MCP Server

Prerrequisitos

• Node.js (v16 o superior)

• Cuenta de Zoom con grabación en la nube habilitada

• Credenciales de la aplicación Zoom OAuth (ID de cuenta, ID de cliente, secreto de cliente)

Instalación

1. Clonar este repositorio:

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

2. Instalar dependencias:

   npm install

3. Construir el proyecto:

   npm run build

Configuración

Cree 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, puede configurar el servidor a través del archivo de configuración 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. Vaya al Zoom App Marketplace e inicie sesión

2. Haga clic en "Desarrollar" > "Crear aplicación".

3. Elija el tipo de aplicación "OAuth de servidor a servidor"

4. Complete la información requerida

5. En "Ámbitos", agregue 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. Anote su ID de cuenta, ID de cliente y secreto de cliente

Uso

Herramientas disponibles

1. lista_de_reuniones

Enumera las reuniones de Zoom disponibles con grabaciones.

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

2. descargar_transcripción

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

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

3. obtener transcripciones recientes

Descarga transcripciones de reuniones recientes.

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

4. transcripciones de búsqueda

Busca contenido específico en las transcripciones descargadas.

{
  "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 de reunión y UUID

• Tema

• Hora de inicio y duración

• Participantes (extraído de la transcripción)

• Ruta del archivo a la transcripción

Desarrollo

Estructura del proyecto

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

Edificio

npm run build

Ejecutando localmente

node build/index.js

Licencia

Instituto Tecnológico de Massachusetts (MIT)