# yanmxa/scriptflow-mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/yanmxa/scriptflow-mcp  
**GitHub Stars:** 8  
**npm Downloads (last month):** 1049637  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/yanmxa-scriptflow-mcp

## Description
A script workflow management system that transforms complex, repetitive AI interactions into persistent, executable scripts. Supports multi-language execution (Bash, Python, Node.js, TypeScript) with guaranteed consistency and reduced hallucination risks.

## Tools
Capabilities this server exposes over MCP:

- **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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "scriptflow-mcp": {
    "command": "npx",
    "args": ["-y","@modelcontextprotocol/inspector"],
    "env": {
      "SCRIPTFLOW_SCRIPTS_DIR": "",
      "SCRIPTFLOW_TIMEOUT": ""
    }
  }
}
```

**Requires environment variables:** `SCRIPTFLOW_SCRIPTS_DIR`, `SCRIPTFLOW_TIMEOUT` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation & README

# ScriptFlow MCP Server

[![npm version](https://badge.fury.io/js/scriptflow-mcp.svg)](https://www.npmjs.com/package/scriptflow-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/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`):

```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

```json
// 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

```bash
# Run tests
npm test

# Test with MCP Inspector
npx @modelcontextprotocol/inspector npx scriptflow-mcp
```