Skip to content

Script workflow management via MCP. Converts AI workflows to persistent scripts, reducing tokens & delays while minimizing hallucination risks.

License

Notifications You must be signed in to change notification settings

yanmxa/scriptflow-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ScriptFlow MCP Server

npm version License: MIT

ScriptFlow is a script workflow management system built on the Model Context Protocol (MCP). It transforms complex, repetitive AI interactions into persistent, executable scripts that can be managed, version-controlled, and reused across sessions.

Why ScriptFlow?

  1. Transform Workflows into Scripts: Convert successful AI interactions into reusable, executable scripts
  2. Save Time & Tokens: Execute complex tasks instantly instead of repeating long conversations
  3. Guaranteed Consistency: Scripts run the same way every time, eliminating AI randomness
  4. Powerful Management: Search, organize, edit, and version your automation library
  5. Team Collaboration: Share proven workflows across your organization

Features

  • Add/Edit/Remove scripts with metadata
  • List/Search scripts by name, description, or tags
  • Execute scripts with arguments
  • Multi-language support (Bash, Python, Node.js, TypeScript)

Setup

Add to your MCP client config (e.g., Claude Desktop claude_desktop_config.json):

{ "mcpServers": { "scriptflow": { "command": "npx", "args": ["scriptflow-mcp"], "env": { "SCRIPTFLOW_SCRIPTS_DIR": "/your/custom/path" } } } }

Environment Variables:

  • SCRIPTFLOW_SCRIPTS_DIR: Scripts directory (default: /tmp/scriptflow-mcp/scripts)
  • SCRIPTFLOW_TIMEOUT: Execution timeout in ms (default: 30000)

Available Tools

  • script_add - Add new script (name, description, content, language, tags)
  • script_edit - Update existing script
  • script_get - View script details
  • script_list - Search/filter scripts
  • script_run - Execute script with arguments
  • script_rm - Remove script

Quick Example

// Add script {"name": "hello", "description": "Hello script", "content": "echo 'Hello!'"} // Run script  {"name": "hello", "args": ["World"]} // List scripts {"search": "hello"}

Storage

Scripts stored as {name}.{ext} + {name}.json metadata files. Supports: Bash (.sh), Python (.py), JavaScript (.js), TypeScript (.ts)

Testing

# Run tests npm test # Test with MCP Inspector npx @modelcontextprotocol/inspector npx scriptflow-mcp

About

Script workflow management via MCP. Converts AI workflows to persistent scripts, reducing tokens & delays while minimizing hallucination risks.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •