Social MCP

A Model Context Protocol (MCP) server for social media integration, specifically Instagram transcript extraction using AssemblyAI.

Prerequisites

Install uv

On Mac:

brew install uv

On Windows:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

After installation on Windows, add uv to your PATH:

set Path=C:\Users\nntra\.local\bin;%Path%

Environment Setup

1. Create a .env file in the project root with your AssemblyAI API key:

# Get your API key from: https://www.assemblyai.com/
ASSEMBLYAI_API_KEY=your_assemblyai_api_key_here

2. Get your AssemblyAI API key:
   • Sign up at AssemblyAI
   • Go to your dashboard and copy your API key
   • Add it to the .env file

Claude Desktop Integration

To use this MCP server with Claude Desktop, you need to add it to your Claude Desktop configuration.

1. Open your Claude Desktop configuration file:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the following configuration to your mcpServers section (replace /path/to/your/social-mcp with the actual path to this project folder):

{
  "mcpServers": {
    "social": {
      "command": "/Users/your-username/.local/bin/uv",
      "args": ["--directory", "/path/to/your/social-mcp", "run", "main.py"]
    }
  },
  "globalShortcut": ""
}

Important: Make sure to replace:

• /path/to/your/social-mcp with the actual path to where you cloned/downloaded this project
• /Users/your-username/.local/bin/uv with the correct path to your uv installation (on Windows this would typically be C:\Users\your-username\.local\bin\uv.exe)

3. Save the file and restart Claude Desktop

Usage

Once configured, the Social MCP server will be available in Claude Desktop. You can use it to:

• Extract transcripts from Instagram videos/reels by providing Instagram URLs
• Get timestamped transcriptions with speaker labels
• Process various Instagram URL formats (posts, reels, IGTV)

Example

Extract transcript from: https://instagram.com/reel/ABC123/

The server will:

1. Extract the video URL from the Instagram post
2. Use AssemblyAI to transcribe the audio
3. Return a formatted transcript with timestamps and speaker labels

Development

This project uses uv for dependency management. The dependencies are defined in pyproject.toml and the lockfile is uv.lock.

To run the server locally:

uv run main.py

Features

• ✅ Instagram URL validation and processing
• ✅ Direct video URL extraction using instaloader
• ✅ AssemblyAI transcription with speaker labels
• ✅ Timestamp formatting
• ✅ Environment variable configuration
• ✅ Comprehensive error handling