https://github.com/yanmxa/scriptflow-mcp
Script workflow management via MCP. Converts AI workflows to persistent scripts, reducing tokens & delays while minimizing hallucination risks.
https://github.com/yanmxa/scriptflow-mcp
agentic-workflows ai-optimization mcp script-management token-reduction workflow-automation
Last synced: 3 months ago
JSON representation
Script workflow management via MCP. Converts AI workflows to persistent scripts, reducing tokens & delays while minimizing hallucination risks.
- Host: GitHub
- URL: https://github.com/yanmxa/scriptflow-mcp
- Owner: yanmxa
- License: mit
- Created: 2025-08-04T04:31:37.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-08-04T07:09:11.000Z (4 months ago)
- Last Synced: 2025-08-04T07:32:32.897Z (4 months ago)
- Topics: agentic-workflows, ai-optimization, mcp, script-management, token-reduction, workflow-automation
- Language: TypeScript
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **ScriptFlow** - Transform complex, repetitive AI interactions into persistent, executable scripts with comprehensive script management (add, edit, remove, list, search, execute) and multi-language support (Bash, Python, Node.js, TypeScript). `http` `ai` `git` `github` (📦 Other)
README
# ScriptFlow MCP Server
[](https://www.npmjs.com/package/scriptflow-mcp)
[](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
```