Skip to content

naftiko/youtube-sandbox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Naftiko Youtube Sandbox

One-click container deploy of a Naftiko Framework capability that wraps the Youtube API. Backed by mocks at mocks.naftiko.net — no upstream credentials required.

Run it

Run in Cloudflare Deploy to Render Run on Google Cloud Deploy on Railway Run on Replit

The Cloudflare button gives you the full three-protocol surface (MCP + REST + SKILL) via the bundled Worker proxy. The other four buttons expose the MCP server on port 3001 directly. See Per-platform behavior below.

What this deploys

Adapter Path Namespace Tools / resources
MCP POST /mcp youtube-sandbox-tools 3 starter tools
REST /api/... youtube-sandbox-api 3 REST resources mirroring the MCP tools
SKILL /skill youtube-sandbox-skills One skill group bundling the starter tools

Backed by:

  • Youtube API at mocks.naftiko.net/rest/youtube-analytics-api/2.0.0 — hosted in naftiko/sandboxes
  • 1 additional OpenAPI(s) hosted in naftiko/sandboxes but not yet wired into this capability

The MCP server requires a bearer token. The deploy ships a dummy sk-mcp-YYYYYYYYYYYY so you can wire it into a client immediately. Real deployments swap before redeploying.

Starter scope vs. full surface

This capability bootstraps 3 representative GET operations from the primary OpenAPI (youtube-analytics-api). To expose more operations, edit capability/shared/youtube-analytics-api-consumes.yml and capability/youtube-sandbox.naftiko.yml — add a resource per OpenAPI path and a tool per operation.

Files

Path What it is
capability/youtube-sandbox.naftiko.yml The Naftiko Framework capability YAML
capability/shared/youtube-analytics-api-consumes.yml Imported consumes block — points at the central Microcks mock
capability/shared/secrets.yaml Dummy MCP server bearer token
Dockerfile Builds on ghcr.io/naftiko/framework:latest, copies capability/ into /app/ — read by every platform
wrangler.toml Cloudflare-only — Durable Object–backed YoutubeSandboxContainer
src/index.ts Cloudflare-only — Worker proxy fronting the three engine ports
render.yaml Render-only — Blueprint that pins PORT=3001 to the Dockerfile

Cloud Run, Railway, and Replit auto-detect the Dockerfile and need no extra config in the repo.

Per-platform behavior

Button Public surface Notes
Cloudflare /mcp + /api/... + /skill + landing page on / Worker proxies three ports through one hostname.
Render MCP only on PORT=3001 Free tier with cold-starts.
Google Cloud Run MCP only on PORT=3001 Scales to zero.
Railway MCP only on the assigned hostname Auto-detects Dockerfile.
Replit MCP only inside the Replit container Best for "kick the tires" exploration.

Local development

npm install
npm run dev

Source

About

This is. sandbox for the YouTube API.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors