@hasdata/youtube-mcp 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +22 -10
  2. package/package.json +32 -8
package/README.md CHANGED
@@ -8,9 +8,12 @@ A hosted Model Context Protocol (MCP) server that gives Claude, Cursor, Windsurf
8
8
  https://mcp.hasdata.com/api/mcp?apis=youtube
9
9
  ```
10
10
 
11
+ [![Glama score](https://glama.ai/mcp/servers/HasData/youtube-mcp/badges/score.svg)](https://glama.ai/mcp/servers/HasData/youtube-mcp)
11
12
  [![tool contract](https://github.com/HasData/youtube-mcp/actions/workflows/contract.yml/badge.svg)](https://github.com/HasData/youtube-mcp/actions/workflows/contract.yml)
12
13
  [![MCP](https://img.shields.io/badge/MCP-remote%20%7C%20streamable%20HTTP-6366f1?style=flat-square)](https://modelcontextprotocol.io)
13
14
  [![Tools](https://img.shields.io/badge/tools-4-10b981?style=flat-square)](#tools)
15
+ [![npm](https://img.shields.io/npm/v/@hasdata/youtube-mcp?style=flat-square&logo=npm&label=npm&color=cb3837)](https://www.npmjs.com/package/@hasdata/youtube-mcp)
16
+ [![PyPI](https://img.shields.io/pypi/v/hasdata-youtube-mcp?style=flat-square&logo=pypi&logoColor=white&label=PyPI&color=3775a9)](https://pypi.org/project/hasdata-youtube-mcp/)
14
17
  [![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
15
18
 
16
19
  ## Contents
@@ -31,7 +34,7 @@ https://mcp.hasdata.com/api/mcp?apis=youtube
31
34
 
32
35
  ## What you need
33
36
 
34
- An MCP client that speaks streamable HTTP with custom headers. A HasData API key from the [dashboard](https://app.hasdata.com/sign-up?utm_source=github&utm_medium=syndication&utm_campaign=youtube-mcp), free to create. Nothing else. This is a remote server. There is no package to install, no container to run and no Google account anywhere in the flow.
37
+ An MCP client that speaks streamable HTTP with custom headers. A HasData API key from the [dashboard](https://app.hasdata.com/sign-up?utm_source=github&utm_medium=syndication&utm_campaign=youtube-mcp), free to create. Nothing else. This is a remote server, so the simplest path is a URL and a header, with no container to run and no Google account anywhere in the flow. A stdio-only client can use the `@hasdata/youtube-mcp` (npm) or `hasdata-youtube-mcp` (PyPI) launcher instead.
35
38
 
36
39
  ## Quick start
37
40
 
@@ -60,26 +63,33 @@ claude mcp add --transport http youtube "https://mcp.hasdata.com/api/mcp?apis=yo
60
63
 
61
64
  Settings, then Connectors, then Add custom connector, then paste `https://mcp.hasdata.com/api/mcp?apis=youtube` and sign in.
62
65
 
63
- For the config-file route, Claude Desktop loads only local (stdio) servers, so a remote server is reached through the `mcp-remote` bridge, which needs Node. Add this to `claude_desktop_config.json`:
66
+ For the config-file route, Claude Desktop loads only local (stdio) servers, so it reaches a remote server through a stdio launcher. The `@hasdata/youtube-mcp` package is that launcher, and it reads the key from the environment. Add this to `claude_desktop_config.json`:
64
67
 
65
68
  ```json
66
69
  {
67
70
  "mcpServers": {
68
71
  "youtube": {
69
72
  "command": "npx",
70
- "args": [
71
- "-y",
72
- "mcp-remote",
73
- "https://mcp.hasdata.com/api/mcp?apis=youtube",
74
- "--header",
75
- "x-api-key:HASDATA_API_KEY"
76
- ]
73
+ "args": ["-y", "@hasdata/youtube-mcp"],
74
+ "env": { "HASDATA_API_KEY": "YOUR_KEY" }
77
75
  }
78
76
  }
79
77
  }
80
78
  ```
81
79
 
82
- The `x-api-key:` value carries no space after the colon. Claude Desktop passes the argument without a shell, and a space splits the header.
80
+ Python instead of Node? Swap the launcher for the PyPI package, which `uvx` runs without a manual install:
81
+
82
+ ```json
83
+ {
84
+ "mcpServers": {
85
+ "youtube": {
86
+ "command": "uvx",
87
+ "args": ["hasdata-youtube-mcp"],
88
+ "env": { "HASDATA_API_KEY": "YOUR_KEY" }
89
+ }
90
+ }
91
+ }
92
+ ```
83
93
 
84
94
  </details>
85
95
 
@@ -466,6 +476,8 @@ HasData accesses publicly available data only. A platform's terms may restrict a
466
476
  | Everything else we scrape | [YouTube Scraper API and 54 more](https://hasdata.com/apis/?utm_source=github&utm_medium=syndication&utm_campaign=youtube-mcp) |
467
477
  | Plans and credit costs | [Plans and credit costs](https://hasdata.com/prices?utm_source=github&utm_medium=syndication&utm_campaign=youtube-mcp) |
468
478
  | Keys and usage | [HasData dashboard](https://app.hasdata.com?utm_source=github&utm_medium=syndication&utm_campaign=youtube-mcp) |
479
+ | Node launcher on npm | [@hasdata/youtube-mcp](https://www.npmjs.com/package/@hasdata/youtube-mcp) |
480
+ | Python launcher on PyPI | [hasdata-youtube-mcp](https://pypi.org/project/hasdata-youtube-mcp/) |
469
481
 
470
482
  ## Development
471
483
 
package/package.json CHANGED
@@ -1,16 +1,40 @@
1
1
  {
2
2
  "name": "@hasdata/youtube-mcp",
3
3
  "mcpName": "com.hasdata/youtube",
4
- "version": "1.0.0",
4
+ "version": "1.0.2",
5
5
  "description": "MCP server for YouTube data (search, video, channel, transcript) through HasData's hosted API. No Google Cloud project, no YouTube Data API key.",
6
6
  "type": "module",
7
- "bin": { "hasdata-youtube-mcp": "index.mjs" },
8
- "files": ["index.mjs", "README.md", "LICENSE"],
9
- "scripts": { "test": "node --test" },
10
- "dependencies": { "mcp-remote": "^0.1.43" },
11
- "engines": { "node": ">=18" },
7
+ "bin": {
8
+ "hasdata-youtube-mcp": "index.mjs"
9
+ },
10
+ "files": [
11
+ "index.mjs",
12
+ "README.md",
13
+ "LICENSE"
14
+ ],
15
+ "scripts": {
16
+ "test": "node --test"
17
+ },
18
+ "dependencies": {
19
+ "mcp-remote": "^0.1.43"
20
+ },
21
+ "engines": {
22
+ "node": ">=18"
23
+ },
12
24
  "license": "MIT",
13
- "repository": { "type": "git", "url": "https://github.com/HasData/youtube-mcp.git" },
25
+ "repository": {
26
+ "type": "git",
27
+ "url": "https://github.com/HasData/youtube-mcp.git"
28
+ },
14
29
  "homepage": "https://hasdata.com/apis/youtube-scraper-api",
15
- "keywords": ["mcp", "youtube", "youtube-mcp", "youtube-mcp-server", "model-context-protocol", "hasdata", "scraper", "transcript"]
30
+ "keywords": [
31
+ "mcp",
32
+ "youtube",
33
+ "youtube-mcp",
34
+ "youtube-mcp-server",
35
+ "model-context-protocol",
36
+ "hasdata",
37
+ "scraper",
38
+ "transcript"
39
+ ]
16
40
  }