Package Exports

summarai-mcp
summarai-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (summarai-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

SummarAI MCP Server

A Model Context Protocol (MCP) server that provides YouTube video summarization capabilities through the SummarAI API.

Features

🎥 Summarize YouTube videos using AI
📝 Support for custom prompts
✅ Built-in URL validation
🛡️ Comprehensive error handling
🔌 Easy integration with Claude and other MCP clients
📦 Install and run with npx - no global installation needed!

Quick Start with npx

No installation required! Use npx to run directly:

# Run with default settings
npx summarai-mcp

# Show help
npx summarai-mcp --help

# Show version
npx summarai-mcp --version

Installation Options

Option 1: Use with npx (Recommended)

npx summarai-mcp --mcp

Option 2: Global Installation

npm install -g summarai-mcp
summarai-mcp --mcp

Option 3: Local Installation

npm install summarai-mcp
npx summarai-mcp --mcp

Usage

With Claude Desktop

Add the following to your Claude Desktop configuration file:

For npx usage (recommended):

{
  "mcpServers": {
    "SummarAI": {
      "command": "npx",
      "args": ["-y", "summarai-mcp", "--mcp"],
      "env": {
        "API_KEY": "your-api-key-here",
        "YOUTUBE_VIDEO_SUMMARY_API_URL": "https://your-api-domain.com/api/youtube/summarize"
      }
    }
  }
}

For global installation:

{
  "mcpServers": {
    "SummarAI": {
      "command": "summarai-mcp",
      "args": ["--mcp"],
      "env": {
        "API_KEY": "your-api-key-here",
        "YOUTUBE_VIDEO_SUMMARY_API_URL": "https://your-api-domain.com/api/youtube/summarize"
      }
    }
  }
}

Environment Variables

API_KEY (required): Your SummarAI API key
YOUTUBE_VIDEO_SUMMARY_API_URL (optional): API endpoint URL (defaults to http://localhost:8000/api/youtube/summarize)

Command Line Options

npx summarai-mcp [options]

Options:
  --mcp, --server    Run as MCP server (default)
  --help, -h         Show help message
  --version, -v      Show version number

Available Tools

summarize_youtube_video

Summarizes a YouTube video using the SummarAI API.

Parameters:

youtube_video_url (required): A valid YouTube video URL
custom_prompt (optional): Custom prompt for summarization

Example:

Use the summarize_youtube_video tool with:
- youtube_video_url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
- custom_prompt: "Provide a detailed summary focusing on the main points and key takeaways"

API Response Format

The tool returns a formatted summary including:

Video title
Video ID
Transcript length
AI-generated summary

Error Handling

The server provides detailed error messages for common issues:

Invalid YouTube URLs
Missing API keys
Network connectivity problems
API rate limits
Server errors

Development

To run locally:

git clone <repository>
cd summarai-mcp
npm install
npm run dev

To build:

npm run build

License

MIT