Nvkanirudh YT To LinkedIn MCP Server

🚀 YouTube 到 LinkedIn MCP 服務器

本項目是一個模型上下文協議（MCP）服務器，能夠自動化地從 YouTube 視頻生成 LinkedIn 帖子草稿。它基於 YouTube 視頻字幕，為用戶提供高質量、可編輯的內容草稿。

🚀 快速開始

本服務器可自動化地從 YouTube 視頻生成 LinkedIn 帖子草稿，為用戶提供便捷的內容創作體驗。

✨ 主要特性

• YouTube 字幕提取：通過視頻鏈接提取 YouTube 視頻的字幕
• 字幕總結：使用 OpenAI GPT 生成簡潔的視頻內容摘要
• LinkedIn 帖子生成：創建語氣和風格可定製的職業 LinkedIn 帖子草稿
• 模塊化 API 設計：乾淨的 FastAPI 實現，定義明確的端點
• 容器化部署：準備好在 Smithery 上部署

📦 安裝指南

先決條件

• Python 3.8+
• Docker（用於容器化部署）
• OpenAI API 密鑰
• YouTube 數據 API 密鑰（可選，但推薦以獲得更好的元數據）

本地開發

1. 克隆倉庫：

git clone <repository-url>
cd yt-to-linkedin

2. 創建虛擬環境並安裝依賴項：

python -m venv venv
source venv/bin/activate  # Windows 上：venv\Scripts\activate
pip install -r requirements.txt

3. 在項目根目錄中創建一個 .env 文件，添加你的 API 密鑰：

OPENAI_API_KEY=your_openai_api_key
YOUTUBE_API_KEY=your_youtube_api_key

4. 運行應用程序：

uvicorn app.main:app --reload

5. 訪問 API 文檔：http://localhost:8000/docs

Docker 部署

1. 構建鏡像：

docker build -t yt-to-linkedin .

2. 運行容器：

docker run -p 8000:8000 --env OPENAI_API_KEY=your_key --env YOUTUBE_API_KEY=your_key yt-to-linkedin

💻 使用示例

基礎用法

本服務器提供了多個 API 端點，以下是一些使用示例。

YouTube 字幕提取

// 請求體
{
  "video_id": "string"
}

// 響應
{
  "subtitles": {
    "content": "string",
    "language": "string"
  }
}

LinkedIn 帖子生成

// 請求體
{
  "title": "string",
  "content": "string",
  "format": "markdown" | "plain"
}

// 響應
{
  "post": {
    "id": "string",
    "content": "string",
    "character_count": integer
  }
}

輸出格式化

// 請求體
{
  "post_content": "string",
  "format": "json"
}

// 響應
{
  "content": {
    "post_content": "string",
    "character_count": integer
  },
  "format": "json"
}

📚 詳細文檔

API 端點

1. YouTube 字幕提取

• 端點：/api/v1/subtitles
• 方法：POST
• 請求體：

{
  "video_id": "string"
}

• 響應：

{
  "subtitles": {
    "content": "string",
    "language": "string"
  }
}

2. LinkedIn 帖子生成

• 端點：/api/v1/post
• 方法：POST
• 請求體：

{
  "title": "string",
  "content": "string",
  "format": "markdown" | "plain"
}

• 響應：

{
  "post": {
    "id": "string",
    "content": "string",
    "character_count": integer
  }
}

3. 輸出格式化

• 端點：/api/v1/output
• 方法：POST
• 請求體：

{
  "post_content": "string",
  "format": "json"
}

• 響應：

{
  "content": {
    "post_content": "string",
    "character_count": integer
  },
  "format": "json"
}

環境變量

⚠️ 重要提示

雖然環境變量中的 API 密鑰是可選的（因為它們可以在每次請求中提供），但在本地開發和測試時，建議設置它們。當部署到 Smithery 時，用戶需要在請求中提供自己的 API 密鑰。

📄 許可證

本項目採用 MIT 許可證。