quickcast-mcp 1.0.0 → 1.0.1

package/README.md

@@ -1,7 +1,13 @@
 # QuickCast MCP (Screen-to-Action Protocol)
 
+[![npm version](https://img.shields.io/npm/v/quickcast-mcp.svg?color=c084fc)](https://www.npmjs.com/package/quickcast-mcp)
+[![Agensi Skill](https://img.shields.io/badge/Agensi-Live%20Skill-6366f1.svg)](https://www.agensi.io/skills/quickcast-qa-assistant)
+[![Glama MCP](https://glama.ai/mcp/servers/Miladmet/quickcast-mcp/badges/score.svg)](https://glama.ai/mcp/servers/Miladmet/quickcast-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/Node.js-20%2B-green.svg)](https://nodejs.org)
+
 > **Autonomous AI Protocol for Screen Recordings**  
-> Turn screen recordings directly into structured GitHub bug reports with video timestamps, executable Playwright E2E tests, and Standard Operating Procedure (SOP) documentation.
+> Turn screen recordings directly into structured GitHub bug reports with clickable video timestamps, executable Playwright E2E tests, and Standard Operating Procedure (SOP) documentation.
 
 Part of the **QuickCast Screen-Recorder** & **Watermark & Resize Studio** ecosystem.
 
@@ -18,7 +24,9 @@ Part of the **QuickCast Screen-Recorder** & **Watermark & Resize Studio** ecosys
 
 ---
 
-## 📦 Installation & Setup
+## 📦 Instant Setup (Claude Desktop & Cursor)
+
+Because `quickcast-mcp` is published on [npm](https://www.npmjs.com/package/quickcast-mcp), you can run it instantly with **zero local file cloning**:
 
 ### 1. Claude Desktop Configuration
 
@@ -31,10 +39,8 @@ Add the following to your `claude_desktop_config.json`:
 {
   "mcpServers": {
     "quickcast": {
-      "command": "node",
-      "args": [
-        "C:\\Users\\Milmann\\.gemini\\antigravity\\scratch\\quickcast-mcp\\src\\index.js"
-      ]
+      "command": "npx",
+      "args": ["-y", "quickcast-mcp"]
     }
   }
 }
@@ -42,21 +48,29 @@ Add the following to your `claude_desktop_config.json`:
 
 ### 2. Cursor Configuration
 
-Add to your project's `.cursor/mcp.json` or global Cursor MCP Settings:
+Add to your project's `.cursor/mcp.json` or Cursor MCP Settings:
 
 ```json
 {
   "mcpServers": {
     "quickcast": {
-      "command": "node",
-      "args": [
-        "C:\\Users\\Milmann\\.gemini\\antigravity\\scratch\\quickcast-mcp\\src\\index.js"
-      ]
+      "command": "npx",
+      "args": ["-y", "quickcast-mcp"]
     }
   }
 }
 ```
 
+### 3. Smithery 1-Click Install
+
+```bash
+npx -y @smithery/cli install quickcast-mcp --client claude
+```
+
+### 4. AI Agent Skill (`SKILL.md`)
+
+QuickCast MCP is officially published as a verified skill on **[Agensi.io](https://www.agensi.io/skills/quickcast-qa-assistant)** and is packaged with an autonomous [`SKILL.md`](./SKILL.md) specification compatible with **Claude Code, Cursor, Windsurf, OpenClaw, and GitHub Copilot**. It teaches your AI agent how to automatically invoke QuickCast tools to turn recording sessions into tests, bug reports, and SOPs.
+
 ---
 
 ## 🛠️ MCP Tools Reference
@@ -80,6 +94,13 @@ Add to your project's `.cursor/mcp.json` or global Cursor MCP Settings:
 
 ---
 
+## 🌐 Managed QA & Automation Services
+
+Need a dedicated, automated Playwright regression testing suite and daily CI monitoring built for your web application?
+Visit **[Watermark & Resize Studio QA Automation](https://watermarkresizestudio.com/qa-automation/)** for turnkey Testing as a Service (TaaS).
+
+---
+
 ## 📄 License
 
 MIT © [Watermark & Resize Studio](https://watermarkresizestudio.com)

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "quickcast-mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "High-performance Model Context Protocol (MCP) server for QuickCast Screen-to-Action Protocol: automated bug reporting, Playwright E2E test scaffolding, and SOP generation from QuickCast recordings.",
   "main": "src/index.js",
+  "types": "src/index.d.ts",
   "bin": {
     "quickcast-mcp": "src/index.js"
   },

package/src/index.d.ts

@@ -0,0 +1,81 @@
+/**
+ * QuickCast MCP Server TypeScript Definitions
+ * Screen-to-Action Protocol: Automated bug reporting, Playwright E2E scaffolding, and SOP generation.
+ */
+
+export interface Marker {
+  id?: string;
+  timestampSeconds: number;
+  label?: string;
+  type?: 'click' | 'navigation' | 'input' | 'assertion' | 'error';
+  targetSelector?: string;
+  notes?: string;
+}
+
+export interface EnvironmentInfo {
+  url?: string;
+  browser?: string;
+  os?: string;
+  resolution?: string;
+  userAgent?: string;
+}
+
+export interface QuickCastSession {
+  sessionId: string;
+  recordedAt: string;
+  durationSeconds: number;
+  watchUrl: string;
+  environment?: EnvironmentInfo;
+  markers?: Marker[];
+  summary?: string;
+}
+
+export interface GetLatestSessionParams {
+  session_id?: string;
+  watch_url?: string;
+  session_data?: string;
+  session_file?: string;
+}
+
+export interface ListRecentSessionsParams {
+  limit?: number;
+  session_file?: string;
+}
+
+export interface FormatGithubBugReportParams {
+  session_id?: string;
+  session_file?: string;
+  issue_title?: string;
+  expected_behavior?: string;
+  actual_behavior?: string;
+}
+
+export interface ScaffoldPlaywrightTestParams {
+  session_id?: string;
+  session_file?: string;
+  language?: 'typescript' | 'javascript';
+  test_name?: string;
+}
+
+export interface GenerateSopGuideParams {
+  session_id?: string;
+  session_file?: string;
+  workflow_name?: string;
+  title?: string;
+}
+
+export interface IngestSessionParams {
+  watchUrl: string;
+  durationSeconds: number;
+  markers?: Marker[];
+  environment?: EnvironmentInfo;
+  session_file?: string;
+}
+
+export declare function loadSessions(customFilePath?: string): QuickCastSession[];
+export declare function saveSession(sessionData: Partial<QuickCastSession>, customFilePath?: string): QuickCastSession;
+export declare function getLatestSession(sessionId?: string, watchUrl?: string, customFilePath?: string): QuickCastSession | null;
+export declare function formatGithubBugReport(session: QuickCastSession, options?: { issue_title?: string; expected_behavior?: string; actual_behavior?: string }): string;
+export declare function scaffoldPlaywrightTest(session: QuickCastSession, options?: { language?: 'typescript' | 'javascript'; test_name?: string }): string;
+export declare function generateSopGuide(session: QuickCastSession, options?: { workflow_name?: string; title?: string }): string;
+export declare function formatTime(seconds: number): string;

package/src/sessionManager.js

@@ -22,7 +22,7 @@ export function formatTime(seconds = 0) {
  * Searches candidate locations to locate QuickCast sessions.
  */
 export function resolveSessionFile(customPath) {
-  if (customPath && fs.existsSync(customPath)) {
+  if (customPath) {
     return customPath;
   }
 
@@ -123,7 +123,11 @@ export function getLatestSession(params = {}) {
   }
 
   if (sessions.length > 0) {
-    return sessions[0];
+    const s = sessions[0];
+    return {
+      ...s,
+      markers: Array.isArray(s.markers) ? s.markers : [],
+    };
   }
 
   // Graceful fallback template when no recordings are registered yet