mcp-server-youtube-info 0.1.3__tar.gz → 0.1.5__tar.gz

mcp_server_youtube_info-0.1.5/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: mcp-server-youtube-info
+Version: 0.1.5
+Summary: A YouTube information retrieval server implementation for Model Context Protocol (MCP)
+Project-URL: Homepage, https://github.com/yareyaredesuyo/mcp-servers
+Project-URL: Repository, https://github.com/yareyaredesuyo/mcp-servers.git
+Project-URL: Documentation, https://github.com/yareyaredesuyo/mcp-servers#readme
+Project-URL: Bug Tracker, https://github.com/yareyaredesuyo/mcp-servers/issues
+Author-email: yareyaredesuyo <yareyaredesuyo@gmail.com>
+License-Expression: MIT
+Keywords: automation,llm,mcp,model-context-protocol,youtube
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: argparse>=1.4.0
+Requires-Dist: fastmcp>=2.5.2
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pillow>=11.2.1
+Requires-Dist: yt-dlp>=2025.5.22
+Description-Content-Type: text/markdown
+
+# MCP YouTube Info Server
+
+This project is a server implementation that retrieves YouTube video information using the Model Context Protocol (MCP). It utilizes the FastMCP framework to provide functionality for fetching YouTube video data.
+
+## Available Tools
+
+### youtube_metainfo
+
+Retrieves metadata for a YouTube video.
+
+- `video_id` (string, required): YouTube video ID
+
+  - Returns: JSON containing metadata such as title, description, view count, publication date, etc.
+
+### youtube_thumbnail_url
+
+Retrieves the URL of a YouTube video's thumbnail image.
+
+- `video_id` (string, required): YouTube video ID
+
+  - Returns: URL of the thumbnail image
+
+### youtube_thumbnail_image
+
+Retrieves the image data from a YouTube video.
+
+- `video_id` (string, required): YouTube video ID
+
+  - Returns: Thumbnail image
+
+## Installation
+
+### Using `uv` (recommended)
+
+No special installation is needed when using `uv`. You can run `mcp-server-youtube-info` directly with `uvx`.
+
+### Using PIP
+
+Alternatively, you can install `mcp-server-youtube-info` using pip:
+
+```
+pip install mcp-server-youtube-info
+```
+
+After installation, you can run it as a script like this:
+
+```
+mcp-server-youtube-info
+```
+
+## Configuration
+
+### Configure for Claude.app
+
+Add to your Claude settings:
+
+<details>
+<summary>Using uvx</summary>
+
+```json
+{
+  "mcpServers": {
+    "testing": {
+      "command": "uvx",
+      "args": ["mcp-server-youtube-info"]
+    }
+  }
+}
+```
+
+</details>
+
+### Configure for VS Code
+
+For quick installation, use one of the one-click install buttons below...
+
+[![Install with UV in VS Code](https://img.shields.io/badge/VS_Code-UV-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=youtube-info&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-youtube-info%22%5D%7D)
+
+### Command-Line Options
+
+You can specify the following options when running the server:
+
+- `--sse`: Enable SSE transport
+
+  - Choices: `on`, `off`
+  - Default: `off`
+  - Description: Enables SSE transport when set to "on"
+
+- `--host`: Host to bind the server to
+
+  - Default: `localhost`
+  - Description: Specifies the host address the server will bind to
+
+- `--port`: Port to bind the server to
+
+  - Type: Integer
+  - Default: `8000`
+  - Description: Specifies the port number the server will bind to
+
+- `--log-level`: Set the log level
+
+  - Choices: `debug`, `info`, `warning`, `error`
+  - Default: `info`
+  - Description:
+
+    - debug: Detailed debug information
+    - info: General runtime information (default)
+    - warning: Potential issues that do not affect execution
+    - error: Errors encountered during execution

mcp_server_youtube_info-0.1.5/README.md

@@ -0,0 +1,109 @@
+# MCP YouTube Info Server
+
+This project is a server implementation that retrieves YouTube video information using the Model Context Protocol (MCP). It utilizes the FastMCP framework to provide functionality for fetching YouTube video data.
+
+## Available Tools
+
+### youtube_metainfo
+
+Retrieves metadata for a YouTube video.
+
+- `video_id` (string, required): YouTube video ID
+
+  - Returns: JSON containing metadata such as title, description, view count, publication date, etc.
+
+### youtube_thumbnail_url
+
+Retrieves the URL of a YouTube video's thumbnail image.
+
+- `video_id` (string, required): YouTube video ID
+
+  - Returns: URL of the thumbnail image
+
+### youtube_thumbnail_image
+
+Retrieves the image data from a YouTube video.
+
+- `video_id` (string, required): YouTube video ID
+
+  - Returns: Thumbnail image
+
+## Installation
+
+### Using `uv` (recommended)
+
+No special installation is needed when using `uv`. You can run `mcp-server-youtube-info` directly with `uvx`.
+
+### Using PIP
+
+Alternatively, you can install `mcp-server-youtube-info` using pip:
+
+```
+pip install mcp-server-youtube-info
+```
+
+After installation, you can run it as a script like this:
+
+```
+mcp-server-youtube-info
+```
+
+## Configuration
+
+### Configure for Claude.app
+
+Add to your Claude settings:
+
+<details>
+<summary>Using uvx</summary>
+
+```json
+{
+  "mcpServers": {
+    "testing": {
+      "command": "uvx",
+      "args": ["mcp-server-youtube-info"]
+    }
+  }
+}
+```
+
+</details>
+
+### Configure for VS Code
+
+For quick installation, use one of the one-click install buttons below...
+
+[![Install with UV in VS Code](https://img.shields.io/badge/VS_Code-UV-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=youtube-info&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-youtube-info%22%5D%7D)
+
+### Command-Line Options
+
+You can specify the following options when running the server:
+
+- `--sse`: Enable SSE transport
+
+  - Choices: `on`, `off`
+  - Default: `off`
+  - Description: Enables SSE transport when set to "on"
+
+- `--host`: Host to bind the server to
+
+  - Default: `localhost`
+  - Description: Specifies the host address the server will bind to
+
+- `--port`: Port to bind the server to
+
+  - Type: Integer
+  - Default: `8000`
+  - Description: Specifies the port number the server will bind to
+
+- `--log-level`: Set the log level
+
+  - Choices: `debug`, `info`, `warning`, `error`
+  - Default: `info`
+  - Description:
+
+    - debug: Detailed debug information
+    - info: General runtime information (default)
+    - warning: Potential issues that do not affect execution
+    - error: Errors encountered during execution

{mcp_server_youtube_info-0.1.3 → mcp_server_youtube_info-0.1.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcp-server-youtube-info"
-version = "0.1.3"
+version = "0.1.5"
 description = "A YouTube information retrieval server implementation for Model Context Protocol (MCP)"
 readme = "README.md"
 requires-python = ">=3.10"

{mcp_server_youtube_info-0.1.3 → mcp_server_youtube_info-0.1.5}/src/mcp_server_youtube_info/__init__.py

@@ -1,7 +1,7 @@
 from mcp_server_youtube_info.server import mcp
 
 def main():
-    """MCP YouTube Info Server - YouTube情報取得サーバー実装"""
+    """MCP YouTube Info Server"""
     import os
     import argparse
 

{mcp_server_youtube_info-0.1.3 → mcp_server_youtube_info-0.1.5}/src/mcp_server_youtube_info/server.py

@@ -7,13 +7,13 @@ from PIL import Image as PILImage
 mcp = FastMCP("MCP YouTube Info Server", dependencies=["httpx", "Pillow"])
 
 def _extract_info(video_id: str) -> dict:
-    """YouTubeの動画情報を取得します。
+    """Retrieve meta info of YouTube video using yt-dlp.
 
     Args:
-        video_id (str): YouTube動画ID
+        video_id (str): YouTube video ID
 
     Returns:
-        dict: 動画情報
+        dict: Video meta information
     """
     ydl_opts = {
         'quiet': True,
@@ -27,74 +27,73 @@ def _extract_info(video_id: str) -> dict:
             info = ydl.extract_info(url, download=False)
             return info
         except Exception as e:
-            raise Exception(f"動画情報の取得に失敗しました: {str(e)}")
+            raise Exception(f"Failed to retrieve video information: {str(e)}")
 
 @mcp.tool()
 def youtube_metainfo(video_id: str) -> dict:
-    """YouTube動画のメタ情報を取得します。
+    """Retrieve meta info of YouTube video。
 
     Args:
-        video_id (str): YouTube動画ID
+        video_id (str): YouTube video ID
 
     Returns:
-        dict: yt-dlpから取得した生のメタ情報
+        dict: Video meta information
     """
     try:
         return _extract_info(video_id)
     except Exception as e:
-        raise Exception(f"メタ情報の取得に失敗しました: {str(e)}")
+        raise Exception(f"Failed to retrieve metadata: {str(e)}")
 
 @mcp.tool()
 def youtube_thumbnail_url(video_id: str) -> str:
-    """YouTubeのサムネイルURLを取得します。
+    """Retrieve the thumbnail URL of a YouTube video.
 
     Args:
-        video_id (str): YouTube動画ID
+        video_id (str): YouTube Video ID
 
     Returns:
-        str: サムネイル画像のURL
+        str: Thumbnail URL
     """
     try:
         info = _extract_info(video_id)
         thumbnail_url = info.get('thumbnail')
         if not thumbnail_url:
-            raise Exception("サムネイルURLが見つかりません")
+            raise Exception("Cannot find thumbnail URL")
         return thumbnail_url
     except Exception as e:
-        raise Exception(f"サムネイルの取得に失敗しました: {str(e)}")
+        raise Exception(f"Failed to get thumbnail URL: {str(e)}")
+
 @mcp.tool()
 def youtube_thumbnail_image(video_id: str) -> Image:
     """
-    指定されたYouTube動画のサムネイルをダウンロードし、Imageとして返す。
+    Retrieve and download the thumbnail of a YouTube video as an Image.
     
     Args:
-        video_id: ダウンロードするyoutubeサムネイルのvideo_id
+        video_id: YouTube Video ID
     Returns:
-        Image: ダウンロードした画像データ
+        Image: Image object containing the thumbnail data
     """
     try:
         info = _extract_info(video_id)
         thumbnail_url = info.get('thumbnail')
         if not thumbnail_url:
-            raise Exception("サムネイルURLが見つかりません")
+            raise Exception("Cannot find thumbnail URL")
     except Exception as e:
-        raise Exception(f"サムネイルの取得に失敗しました: {str(e)}")
+        raise Exception(f"Failed to get thumbnail URL: {str(e)}")
     
     try:
         with httpx.Client() as client:
             response = client.get(thumbnail_url)
             response.raise_for_status()
             
-            # 画像を読み込んで圧縮
             image = PILImage.open(io.BytesIO(response.content)).convert('RGB')
             buffer = io.BytesIO()
-            # image.save(buffer, format="JPEG", quality=60, optimize=True)
-            image.save(buffer, format="JPEG", quality=60)
+            image.save(buffer, format="JPEG", quality=60, optimize=True)
             
             return Image(data=buffer.getvalue(), format="jpeg")
     except httpx.HTTPStatusError as e:
-        raise Exception(f"HTTPエラー: {e.response.status_code}")
+        raise Exception(f"HTTP Error: {e.response.status_code}")
     except PILImage.UnidentifiedImageError:
-        raise Exception("有効な画像ファイルではありません")
+        raise Exception("Not a valid image format")
     except Exception as e:
-        raise Exception(f"画像のダウンロードに失敗しました: {str(e)}")
+        raise Exception(f"Failed to download image: {str(e)}")

mcp_server_youtube_info-0.1.3/PKG-INFO

@@ -1,105 +0,0 @@
-Metadata-Version: 2.4
-Name: mcp-server-youtube-info
-Version: 0.1.3
-Summary: A YouTube information retrieval server implementation for Model Context Protocol (MCP)
-Project-URL: Homepage, https://github.com/yareyaredesuyo/mcp-servers
-Project-URL: Repository, https://github.com/yareyaredesuyo/mcp-servers.git
-Project-URL: Documentation, https://github.com/yareyaredesuyo/mcp-servers#readme
-Project-URL: Bug Tracker, https://github.com/yareyaredesuyo/mcp-servers/issues
-Author-email: yareyaredesuyo <yareyaredesuyo@gmail.com>
-License-Expression: MIT
-Keywords: automation,llm,mcp,model-context-protocol,youtube
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10
-Requires-Dist: argparse>=1.4.0
-Requires-Dist: fastmcp>=2.5.2
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: pillow>=11.2.1
-Requires-Dist: yt-dlp>=2025.5.22
-Description-Content-Type: text/markdown
-
-# MCP YouTube Info Server
-
-このプロジェクトは、Model Context Protocol (MCP) を使用して YouTube 動画の情報を取得するサーバー実装です。FastMCP フレームワークを使用して、YouTube の動画情報を取得する機能を提供します。
-
-## Available Tools
-
-### thumbnail
-
-YouTube 動画のサムネイル画像の URL を取得します。
-
-- video_id (string, required): YouTube 動画 ID
-  - 戻り値: サムネイル画像の URL
-
-### metainfo
-
-YouTube 動画のメタ情報を取得します。
-
-- video_id (string, required): YouTube 動画 ID
-  - 戻り値: タイトル、説明、視聴回数、投稿日時などのメタ情報を含む JSON
-
-## インストール
-
-### uv の使用（推奨）
-
-uv を使用する場合、特別なインストールは必要ありません。`uvx` を使用して直接 `mcp-server-youtube-info` を実行できます。
-
-### PIP の使用
-
-または、pip を使用して `mcp-server-youtube-info` をインストールすることもできます：
-
-```
-pip install mcp-server-youtube-info
-```
-
-インストール後、以下のようにスクリプトとして実行できます：
-
-```
-mcp-server-youtube-info
-```
-
-### コマンドラインオプション
-
-サーバーの実行時に以下のオプションを指定できます：
-
-- `--sse`: SSE トランスポートの有効化
-
-  - 選択肢: `on`, `off`
-  - デフォルト: `off`
-  - 説明: "on"に設定すると SSE トランスポートが有効になります
-
-- `--host`: サーバーをバインドするホスト
-
-  - デフォルト: `localhost`
-  - 説明: サーバーをバインドするホストアドレスを指定します
-
-- `--port`: サーバーをバインドするポート
-
-  - タイプ: 整数
-  - デフォルト: `8000`
-  - 説明: サーバーをバインドするポート番号を指定します
-
-- `--log-level`: ログレベルの設定
-  - 選択肢: `debug`, `info`, `warning`, `error`
-  - デフォルト: `info`
-  - 説明:
-    - debug: 詳細なデバッグ情報
-    - info: 一般的な実行情報（デフォルト）
-    - warning: 実行に影響しない潜在的な問題
-    - error: 実行中に発生したエラー
-
-## 開発
-
-このプロジェクトは、YouTube の動画情報を取得するための MCP サーバーを提供します。新しい機能を追加する場合は、`server.py` に実装を追加してください。
-
-開発時には、以下のコマンドを実行することで、開発中のスクリプトの動作を検証できます。
-
-```
-pip install -e .
-mcp-server-youtube-info
-```

mcp_server_youtube_info-0.1.3/README.md

@@ -1,80 +0,0 @@
-# MCP YouTube Info Server
-
-このプロジェクトは、Model Context Protocol (MCP) を使用して YouTube 動画の情報を取得するサーバー実装です。FastMCP フレームワークを使用して、YouTube の動画情報を取得する機能を提供します。
-
-## Available Tools
-
-### thumbnail
-
-YouTube 動画のサムネイル画像の URL を取得します。
-
-- video_id (string, required): YouTube 動画 ID
-  - 戻り値: サムネイル画像の URL
-
-### metainfo
-
-YouTube 動画のメタ情報を取得します。
-
-- video_id (string, required): YouTube 動画 ID
-  - 戻り値: タイトル、説明、視聴回数、投稿日時などのメタ情報を含む JSON
-
-## インストール
-
-### uv の使用（推奨）
-
-uv を使用する場合、特別なインストールは必要ありません。`uvx` を使用して直接 `mcp-server-youtube-info` を実行できます。
-
-### PIP の使用
-
-または、pip を使用して `mcp-server-youtube-info` をインストールすることもできます：
-
-```
-pip install mcp-server-youtube-info
-```
-
-インストール後、以下のようにスクリプトとして実行できます：
-
-```
-mcp-server-youtube-info
-```
-
-### コマンドラインオプション
-
-サーバーの実行時に以下のオプションを指定できます：
-
-- `--sse`: SSE トランスポートの有効化
-
-  - 選択肢: `on`, `off`
-  - デフォルト: `off`
-  - 説明: "on"に設定すると SSE トランスポートが有効になります
-
-- `--host`: サーバーをバインドするホスト
-
-  - デフォルト: `localhost`
-  - 説明: サーバーをバインドするホストアドレスを指定します
-
-- `--port`: サーバーをバインドするポート
-
-  - タイプ: 整数
-  - デフォルト: `8000`
-  - 説明: サーバーをバインドするポート番号を指定します
-
-- `--log-level`: ログレベルの設定
-  - 選択肢: `debug`, `info`, `warning`, `error`
-  - デフォルト: `info`
-  - 説明:
-    - debug: 詳細なデバッグ情報
-    - info: 一般的な実行情報（デフォルト）
-    - warning: 実行に影響しない潜在的な問題
-    - error: 実行中に発生したエラー
-
-## 開発
-
-このプロジェクトは、YouTube の動画情報を取得するための MCP サーバーを提供します。新しい機能を追加する場合は、`server.py` に実装を追加してください。
-
-開発時には、以下のコマンドを実行することで、開発中のスクリプトの動作を検証できます。
-
-```
-pip install -e .
-mcp-server-youtube-info
-```