
Stream Clipper
io.github.lisn0由 GitHub 帳號 lisn0 發布v0.1.0更新於 Nov 17, 2026
List local clips and prepare them for review or publishing.
發布方自己的服務:Stream Estate
概覽
本機 stdio MCP 伺服器,讓助理瀏覽 Stream Clipper 儲存的已完成 Twitch 剪輯,並可選擇將剪輯存成 PostFling 草稿。
- 可以做什麼
- 列出本機剪輯資料夾中已完成的剪輯,最新的在前,含剪輯 ID、頻道登入名稱、時間戳記以及選用的長度、分數與觸發欄位
- 透過 limit 與 offset 分頁瀏覽剪輯清單
- 可選擇將選取的剪輯上傳到已設定的 PostFling 工作區,並存成對應目的地的可編輯草稿
- 適用情境
- 當你已在執行 Stream Clipper 監控程式,從 Twitch 直播中切出片段,並希望助理在聊天用戶端內檢視、挑選或轉交已完成的剪輯時使用。
- 執行需求
- 以本機程序執行,透過 npx(Node.js)或 uvx/PyPI 啟動,並以參數傳入剪輯資料夾的絕對路徑;該資料夾需已有完成的 MP4 檔案及其 insights 附屬檔案。選用的草稿工具需要 PostFling 設定 JSON 路徑,以及伺服器環境中的 POSTFLING_EMAIL 與 POSTFLING_PASSWORD。Twitch 監控程式需另外執行,並需要 Twitch 憑證與影片工具。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Stream Clipper,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
Stream Clipper
Automatically cut local clips from live Twitch streams using chat activity spikes. Stream Clipper monitors selected channels and saves candidate MP4s for review. Browse finished clips through the local MCP server or send selected clips to PostFling as drafts.
PyPI · npm · MCP Registry
Clip live Twitch streams · Browse local clips with MCP
Clip live Twitch streams
Requirements
- Python 3.10 or newer. The core pipeline uses only the Python standard library.
- A Twitch application client ID and secret for live-stream polling.
- yt-dlp and
FFmpeg and ffprobe on
PATHfor recording and export. The chat-only checks do not require video tools. - Optional dependencies include Tesseract with English data for
--fortnite-hudand faster-whisper with a cached Whisper Small model for speech-assisted options.
Install from PyPI
Install the CLI from PyPI in a Python virtual environment:
Use stream-clipping to run the monitor and stream-clipping-postfling to
preview or upload clips for draft review. From a source checkout, you can also
run python3 pipeline/live_monitor.py and python3 pipeline/push_to_postfling.py
with the same arguments.
Twitch use and authorization
The monitor reads stream status from Twitch Helix and chat from Twitch IRC. Live recording uses yt-dlp. Use it only where you have authorization to record the broadcast and retain the footage and chat under Twitch's Terms of Service. Obtain the necessary rights before sharing clips, including rights for any third-party material in the clip. Twitch also documents its official clip creation and retrieval API.
The monitor requires an explicit --channels list; there is no implicit channel
selection. Use channel login names separated by commas.
Configure and run
Create a local Twitch credential file (keep it outside source control):
Save it as secrets/twitch.env or another local path. Do not commit it. First
run a short dry-run to check Twitch polling and chat connectivity. This mode
does not record video:
After reviewing the dry-run output, start live recording and clipping:
Stop with Ctrl-C. The staging directory defaults to ./output/live. The
monitor keeps recordings and event logs there. Finished MP4s and their
*_insights.json sidecars go in clips/ under staging. The default disk
reserve pauses recording as free space falls. Recordings and exported clips
can accumulate across sessions, so set a retention policy for staging.
By default, the chat log stores event metadata such as time and message rate.
--save-chat-samples adds short raw chat excerpts. Restrict access to staging
and retain recordings, chat logs, and clips only as long as necessary.
For a bounded connectivity check, use --smoke SECONDS with exactly one
explicit channel and the credential file. That channel must be live. Smoke mode
checks Twitch polling and chat but does not record. Use an active chat:
Optional PostFling draft review
PostFling is optional. Its uploader defaults to review mode, which uploads
the selected clips and saves editable workspace drafts for a person to review.
It does not initiate publishing in that mode. Preview locally first with
--dry-run:
To save drafts, load POSTFLING_EMAIL and POSTFLING_PASSWORD into the
process environment from your secret store and omit --dry-run:
The default origin is http://127.0.0.1:8477 for local testing. For a remote
instance, set POSTFLING_URL to the HTTPS origin, such as
https://workspace.example, without an API path. The client rejects redirects.
Direct delivery is an explicit --mode direct action. Use it only when you
have the required rights and authorization for the content and destination.
Review each draft and destination before choosing direct delivery.
Browse local clips with MCP
The stdio server lets an MCP client browse completed live clips while the monitor runs separately. Use an absolute path to a clips directory writable only by you and the monitor. Create it or wait for the monitor to save a clip before connecting the client.
With Node.js and uvx on your MCP client's PATH, launch the server from npm:
The launcher uses the published PyPI package. Call list_clips to see completed
clips in that folder.
Run with uvx or install from PyPI
With uvx, the client can launch the PyPI package with its MCP dependencies:
If your client cannot find uvx on its PATH, use the absolute path to it.
You can also run python -m pip install 'stream-clipper[mcp]' in a virtual
environment and point the client at the installed stream-clipping-mcp
executable with --clips-dir and the absolute directory path as arguments.
Launch from a source checkout
Install the MCP Python SDK in a virtual environment for the client to launch.
Use absolute paths in your client's MCP server configuration.
MCP tools
list_clips shows the newest completed MP4 and insights pairs first. It returns
clip IDs, Twitch logins, Unix timestamps, and optional duration, score, and
trigger fields. Use limit (1–100, default 25) and offset (default 0) to page
through results.
To enable save_postfling_draft, append --postfling-config and the absolute
path to a JSON file to args. Use the same workspace and Twitch-login mapping
as the live monitor. Supply POSTFLING_EMAIL and POSTFLING_PASSWORD to the
server process through your client's secret environment or launch wrapper.
Call save_postfling_draft with a clip_id from list_clips. The tool uploads
that MP4 to the configured PostFling workspace and saves an editable draft for
the mapped destination. Review and publish through PostFling.
Client plugins
The Claude Code, Antigravity, Cursor, and Gemini CLI packages launch the local MCP
server. Put Node.js and uvx on the client's PATH. Set Clips directory to
the absolute path to a folder containing completed MP4 files and their
*_insights.json sidecars.
Open the plugin from this repository. In Claude Code, run claude --plugin-dir ./plugins/claude
from a checkout. In Antigravity, use agy plugin install .. In Cursor, use
Import from Disk in Customize. For Gemini CLI, install this repository with gemini extensions install https://github.com/lisn0/stream-clipper. Start Gemini CLI from your clips folder.
Ask the client to list the newest clips. The plugin browses completed clips
using list_clips. The Twitch monitor is started separately.
Tests
With FFmpeg and ffprobe installed, run the full suite from the repository root:
License
Project code is under the MIT License. The external tools and model weights retain their own licenses.
Maintainer releases
Set the same version in pyproject.toml and package.json. Build and test the
Python distributions and the npm archive from that source. Attach these three
files to the stable GitHub release before publishing it.
stream_clipper-X.Y.Z-py3-none-any.whlstream_clipper-X.Y.Z.tar.gzstream-clipper-X.Y.Z.tgz
Publishing the GitHub release with tag vX.Y.Z uploads the Python distributions
to PyPI first and the npm launcher second. Both registries require a trusted
publisher for publish-pypi.yml. The PyPI job uses the pypi environment.
To update the MCP Registry listing, match the versions in server.json to the
published npm package. Push the manifest, then use mcp-publisher publish server.json
from a machine authenticated to the official registry.
來源:README.md,提交 fb9e15d
工具
0版本歷史
1- v0.1.0最新Nov 17, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分
其他 Stream 整合
Stream Estate
estate.stream官方發布者
遠端 MCP 伺服器,透過 Stream Estate API v2 讓助理存取法國房地產物件、市場資料與房產提醒。

Deutschlandfunk — German public radio news: rolling news, topics, articles & live stream
由 GitHub 帳號 mohammad-abbasi-sh 發布
唯讀 MCP 伺服器,讓助理取得德國之聲 Deutschlandfunk 的即時新聞、主題新聞、文章全文與直播串流連結。

AuraStream
由 GitHub 帳號 UnbiasedAlpha 發布
AuraStream MCP 透過單一 API 從 45 個以上來源取得歷史行情、總體經濟、持倉與基本面時間序列,讓助理直接取數並比較。

GenPark Reservoir Sampling Stream Auditor
由 GitHub 帳號 alphaparkinc 發布
本機 MCP 伺服器,提供無偏蓄水池抽樣與分位數估計,鎖定 LLM 遙測等資料流。

pubmed-stream
由 GitHub 帳號 melhzy 發布
檢索 PubMed 與 PMC,下載開放全文並精簡讀取,梳理引用關係,並建立 Obsidian 知識圖譜。