ScriptFlow MCP Server

1# ScriptFlow MCP Server
2 
3[![npm version](https://badge.fury.io/js/scriptflow-mcp.svg)](https://www.npmjs.com/package/scriptflow-mcp)
4[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5 
6ScriptFlow 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.
7 
8## Why ScriptFlow?
9 
101. **Transform Workflows into Scripts**: Convert successful AI interactions into reusable, executable scripts
112. **Save Time & Tokens**: Execute complex tasks instantly instead of repeating long conversations
123. **Guaranteed Consistency**: Scripts run the same way every time, eliminating AI randomness
134. **Powerful Management**: Search, organize, edit, and version your automation library
145. **Team Collaboration**: Share proven workflows across your organization
15 
16## Features
17 
18- **Add/Edit/Remove** scripts with metadata
19- **List/Search** scripts by name, description, or tags  
20- **Execute** scripts with arguments
21- **Multi-language** support (Bash, Python, Node.js, TypeScript)
22 
23## Setup
24 
25Add to your MCP client config (e.g., Claude Desktop `claude_desktop_config.json`):
26 
27```json
28{
29  "mcpServers": {
30    "scriptflow": {
31      "command": "npx",
32      "args": ["scriptflow-mcp"],
33      "env": {
34        "SCRIPTFLOW_SCRIPTS_DIR": "/your/custom/path"
35      }
36    }
37  }
38}
39```
40 
41**Environment Variables:**
42- `SCRIPTFLOW_SCRIPTS_DIR`: Scripts directory (default: `/tmp/scriptflow-mcp/scripts`)
43- `SCRIPTFLOW_TIMEOUT`: Execution timeout in ms (default: `30000`)
44 
45## Available Tools
46 
47- `script_add` - Add new script (name, description, content, language, tags)
48- `script_edit` - Update existing script  
49- `script_get` - View script details
50- `script_list` - Search/filter scripts
51- `script_run` - Execute script with arguments
52- `script_rm` - Remove script
53 
54## Quick Example
55 
56```json
57// Add script
58{"name": "hello", "description": "Hello script", "content": "echo 'Hello!'"}
59 
60// Run script  
61{"name": "hello", "args": ["World"]}
62 
63// List scripts
64{"search": "hello"}
65```
66 
67## Storage
68 
69Scripts stored as `{name}.{ext}` + `{name}.json` metadata files.
70Supports: Bash (.sh), Python (.py), JavaScript (.js), TypeScript (.ts)
71 
72## Testing
73 
74```bash
75# Run tests
76npm test
77 
78# Test with MCP Inspector
79npx @modelcontextprotocol/inspector npx scriptflow-mcp
80```