luis/mcp-servers
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add pinchflat-mcp package #4

Merged
luis merged 1 commits from feat/pinchflat-mcp into main 2026-07-05 00:10:25 +02:00
Conversation 0 Commits 1 Files Changed 3
+269
hermes-agent commented 2026-07-05 00:05:54 +02:00
Collaborator
Copy Link
Copy Source

New MCP server for Pinchflat, the YouTube media downloader.

What it does

Python MCP server (fastmcp + httpx) that wraps the Pinchflat REST API (/api/v1) as MCP tools:

Sources: list, get, create, update, delete, force_download_pending, force_redownload, force_index, force_metadata_refresh
Media: list, search, get, force_download
Media Profiles: list, get
Tasks: list, get
Settings/Info: get_settings, get_app_info

Files

  • packages/pinchflat-mcp/server.py — the MCP server (226 lines)
  • packages/pinchflat-mcp/package.nix — Nix derivation (stdenv + makeWrapper, same pattern as sabnzbd-mcp)
  • packages/default.nix — registered

Testing

Tested against the live Pinchflat instance (https://pinchflat.bueso.eu):

  • ✅ 28 sources listed
  • ✅ Search for "dumpling" returns correct result
  • ✅ Media profiles listed
  • ✅ App info returned (v2025.9.26, yt-dlp 2026.06.09)
  • ✅ MCP stdio initialize handshake works

Config

Env vars: PINCHFLAT_URL (base URL) + PINCHFLAT_API_TOKEN (bearer token)

New MCP server for Pinchflat, the YouTube media downloader. ## What it does Python MCP server (fastmcp + httpx) that wraps the Pinchflat REST API (`/api/v1`) as MCP tools: **Sources**: list, get, create, update, delete, force_download_pending, force_redownload, force_index, force_metadata_refresh **Media**: list, search, get, force_download **Media Profiles**: list, get **Tasks**: list, get **Settings/Info**: get_settings, get_app_info ## Files - `packages/pinchflat-mcp/server.py` — the MCP server (226 lines) - `packages/pinchflat-mcp/package.nix` — Nix derivation (stdenv + makeWrapper, same pattern as sabnzbd-mcp) - `packages/default.nix` — registered ## Testing Tested against the live Pinchflat instance (https://pinchflat.bueso.eu): - ✅ 28 sources listed - ✅ Search for "dumpling" returns correct result - ✅ Media profiles listed - ✅ App info returned (v2025.9.26, yt-dlp 2026.06.09) - ✅ MCP stdio initialize handshake works ## Config Env vars: `PINCHFLAT_URL` (base URL) + `PINCHFLAT_API_TOKEN` (bearer token)
hermes-agent added 1 commit 2026-07-05 00:05:54 +02:00
Add pinchflat-mcp package
NixOS Configuration CI / Nix Flake Check (pull_request) Successful in 26s
Details
dc23a30013 
Python MCP server (fastmcp + httpx) that exposes the Pinchflat REST API
as MCP tools. Covers sources, media items, media profiles, tasks, and
settings endpoints.

Tested against live Pinchflat instance — 28 sources, search, app info
all working via stdio transport.
luis merged commit fa32b4a941 into main 2026-07-05 00:10:25 +02:00
luis deleted branch feat/pinchflat-mcp 2026-07-05 00:10:29 +02:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
hermes-agent luis (Luis Bueso)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: luis/mcp-servers#4