mkurecka/supadata-mcp

Supadata MCP Server

MCP server for integrating with Supadata's transcript API, enabling AI assistants to get transcripts from video and audio content.

Features

• Get transcripts from YouTube, TikTok, X/Twitter videos
• Support for audio files (MP4, WEBM, MP3, etc.)
• Multiple transcript modes (native, AI-generated, auto)
• Language selection and detection
• Both plain text and detailed segment formats
• JSON-based configuration (no tool configuration needed)

Setup

1. Install dependencies:

npm install

2. Build the project:

npm run build

3. Configure your API key:

cp supadata-config.json.example supadata-config.json
# Edit supadata-config.json with your API key from https://supadata.ai

Configuration

Option 1: Environment Variables (Recommended)

Set environment variables (useful for MCP server configuration):

export SUPADATA_API_KEY="your-supadata-api-key-here"
export SUPADATA_BASE_URL="https://api.supadata.ai/v1"  # optional

Option 2: JSON Configuration File

Create supadata-config.json in the project root:

{
  "apiKey": "your-supadata-api-key-here",
  "baseUrl": "https://api.supadata.ai/v1"
}

The server will look for configuration in this order:

1. Environment variables (SUPADATA_API_KEY, SUPADATA_BASE_URL)
2. ./supadata-config.json (current working directory)
3. ../supadata-config.json (parent of dist directory)
4. ./dist/supadata-config.json (alongside compiled files)

Usage

Option 1: Desktop Extension (Recommended)

One-click installation:

1. Download supadata-mcp.dxt from releases
2. Double-click to open with Claude Desktop
3. Enter your Supadata API key when prompted
4. Click "Install"

Build extension yourself:

npm run package
# Creates supadata-mcp.dxt file

Option 2: Manual MCP Configuration

Add to your Claude app's MCP server configuration:

{
  "mcpServers": {
    "supadata": {
      "command": "node",
      "args": ["/path/to/supadata-mcp/dist/index.js"],
      "env": {
        "SUPADATA_API_KEY": "your-supadata-api-key-here"
      }
    }
  }
}

Option 3: Without Environment Variables

{
  "mcpServers": {
    "supadata": {
      "command": "node",
      "args": ["/path/to/supadata-mcp/dist/index.js"]
    }
  }
}

(Requires supadata-config.json file)

Tools

get_transcript

Get transcript from video or audio content.

Parameters:

• url (required): Video or audio file URL
• lang (optional): Preferred language code
• text (optional): Return plain text instead of segments (default: false)
• mode (optional): 'native', 'generate', or 'auto' (default: 'auto')

Development

npm run dev           # Build and run
npm run watch         # Watch mode  
npm run lint          # Lint code
npm run typecheck     # Type checking
npm run package       # Build desktop extension (.dxt)
npm run build-extension # Alias for package

Desktop Extension Features

• One-click installation - No complex setup required
• Secure API key storage - Stored in OS keychain
• Cross-platform support - Works on macOS, Windows, Linux
• Automatic updates - Extension updates managed by Claude Desktop
• User-friendly configuration - GUI prompts for API key

Files

• manifest.json - Desktop extension configuration
• build-extension.js - Packaging script for .dxt creation
• supadata-mcp.dxt - Packaged extension (generated)
• src/ - TypeScript source code
• dist/ - Compiled JavaScript (generated)