frame-pulse-mcp

in progress # 🎬 Frame Pulse MCP [](https://github.com/sponsors/IdaAkiwumi) [](https://www.paypal.com/paypalme/iakiwumi) [](https://www.python.org/downloads/) [](https://modelcontextprotocol.io/) [](https://frame-pulse-mcp.streamlit.app) **AI-native telemetry for creative workstations.** Give your AI assistant (Claude, Hermes, Cursor) a "nervous system" to monitor and govern heavy creative workloads—Blender renders, Unreal builds, Houdini simulations—preventing thermal crashes and lost work during crunch.  --- ## 🎯 The Problem Frame Pulse Solves **Digital content creation (DCC) tools are resource-intensive.** During overnight renders or UE5 lighting builds, workstations overheat, hang, or crash—destroying hours of work and missing deadlines. **Existing tools (Glances, htop) show data. Frame Pulse lets AI *act*.** | Traditional Monitoring | Frame Pulse with AI | |----------------------|-------------------| | You watch numbers | Claude asks "Is my system safe?" | | Crash after the fact | Throttle *before* thermal damage | | Manual Task Manager | Natural language "deprioritize Chrome" | | Silent failure | Discord/Telegram alerts at 2AM | --- ## 🚀 Quick Start ### Option A: Claude Desktop (Recommended) 1. **Clone and install** ``` powershell git clone [https://github.com/idaakiwumi/frame-pulse-mcp.git](https://github.com/idaakiwumi/frame-pulse-mcp.git) cd frame-pulse-mcp pip install -r requirements.txt ``` 2. **Add to Claude Desktop config** * **Windows (MSIX/Store):** `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json` * **Other possible paths `\AppData\Roaming\Claude\claude_desktop_config.json` `\AppData\Local\Claude\claude_desktop_config.json` * **Standard:** `%APPDATA%\Claude\claude_desktop_config.json` ``` json { "mcpServers": { "frame-pulse": { "command": "py", "args": [ "-3.14", "-u", "C:\\Users\\YOUR_PATH\\frame-pulse-mcp\\src\\frame_pulse\\server.py" ] } } } ``` Then ask Claude: "Check my system status" or "Deprioritize my background apps" ### Option B: The "Hero Demo" (Streamlit) I built a high-fidelity **Mission Control Dashboard** using Streamlit. While the MCP runs in the background, this dashboard serves as the visual command center for the project. ``` powershell streamlit run streamlit_app/mission_control.py ``` --- ## 📱 The "Digital Pager" Ecosystem (Telegram & Discord) As a **Product Architect**, I designed Frame Pulse to be "Headless." Creative professionals don't want another window to monitor; they want an assistant that pings them when they are away from their desk. * **Telegram Bot:** Acts as a private production pager. Get a message on your phone if your CPU hits 90°C while you're grabbing coffee. * **Discord Webhooks:** Rich, color-coded embeds sent to your studio's Discord server for team-wide render farm monitoring. **Setup:** Configure your `.env` file with your `TELEGRAM_BOT_TOKEN` and `TELEGRAM_CHAT_ID`. --- ## 🛠️ MCP Tools for AI Agents | Tool | Function | Use Case | | :--- | :--- | :--- | | `check_system_health()` | CPU, RAM, and Thermal scan | "Is it safe to start a 6-hour render?" | | `scan_creative_apps()` | Identifies Blender, Unreal, Maya, etc. | "What's currently taxing the GPU?" | | `emergency_throttle()` | Immediate CPU priority reduction | "CRITICAL: Throttle background apps now." | | `get_thermal_status()` | Real-time temperature read | "Am I at risk of a thermal shutdown?" | --- ## 🤝 Community & Recognition **Featured on Lobehub — AI tools discovery platform. ## 🛠️ Built With - **[MCP](https://modelcontextprotocol.io/)** — Model Context Protocol for AI tool interoperability - **[FastMCP](https://github.com/modelcontextprotocol/python-sdk)** — Python SDK for MCP servers - **[psutil](https://github.com/giampaolo/psutil)** — Cross-platform system monitoring - **[Streamlit](https://streamlit.io/)** — Rapid Python dashboarding ## 📸 Demo [30-second GIF: Claude asking "Start my render?" → Frame Pulse responding "CAUTION: CPU 89%" → User clicking throttle → Success toast] ## 🤝 Who's Using This > "Frame Pulse caught a thermal spike before our overnight farm render. Saved us 14 hours of redo work." > — Anonymous VFX Supervisor (via DM) ## ☕ Support the Mission If this tool saved your render from thermal throttling, prevented a 3AM crash, or helped your AI agent make hardware-aware decisions—consider fueling continued development: - [Sponsor on GitHub](https://github.com/sponsors/IdaAkiwumi) - [Donate via PayPal](https://www.paypal.com/paypalme/iakiwumi) --- ## 👩🏽‍💻 Developed by Ida Akiwumi **Lead Product Designer | Creative Technologist | Narrative Strategist** *Translating user friction into product opportunities.* [](https://www.linkedin.com/in/idaa11)