Youtube Notion Summary MCP Server

YouTube转录MCP服务器

一个简单的MCP服务器，可以获取YouTube视频转录并将其保存到Notion。

特性

• 🎥 从YouTube视频中获取全文转录
• 📝 自动获取视频标题
• 💾 将摘要保存到Notion
• 🔐 具有身份验证的安全HTTP传输
• 🐳 Docker易于部署
• 🌐 云部署的代理支持

快速开始

1.环境设置

促进地方发展 -创建一个 .env 文件：

MCP_API_KEY=your-secret-api-key-here
NOTION_API_TOKEN=your-notion-integration-token
NOTION_DATABASE_ID=your-notion-database-id

# Optional: Proxy for cloud deployments (required for Render, AWS, etc.)
PROXY_URL=http://username:password@proxy-server:port

⚠️ 云平台说明： YouTube屏蔽了大多数云提供商IP（AWS、Google cloud、Railway等）。您需要代理服务才能可靠运行。

🆓 免费代理设置（网络共享）

1. 在网上共享注册： https://www.webshare.io/
2. 获得10个免费代理 （无需信用卡）
3. 查找您的代理详细信息 在他们的仪表板上
4. 格式： http://username:password@proxy-endpoint:port
5. 添加到铁路变量： PROXY_URL =您的网络共享代理URL

2.使用Docker运行

# Build the image
docker build -t youtube-transcript-mcp .

# Run the server
docker run -p 8000:8000 -v $(pwd)/.env:/app/.env youtube-transcript-mcp

服务器将在以下时间可用 http://localhost:8000

3.配置MCP客户端

添加到您的MCP客户端配置中（例如。， .cursor/mcp.json):

{
  "mcpServers": {
    "youtube-notion-server": {
      "type": "streamable-http",
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer your-secret-api-key-here"
      }
    }
  }
}

可用工具

• fetch_youtube_transcript(url) -从YouTube视频中获取文字记录和标题
• save_to_notion(link, title, summary) -将视频信息保存到Notion数据库

发展

安装依赖项：

uv sync

在本地运行：

uv run fetch_youtube_transcripts.py --transport http