Workflow Environment
Environment Configuration
- Location: /opt/mcp-servers/workflow/mcp_workflow_server.py
- Version: 2.1.0 (2025-12-23)
- Vault Port: 6615 (master, requires password)
- Operational Port: 6616 (empty - not replicated)
- Locker ID: l_8573
Purpose
Workflow MCP Server stores editable AI protocols, reminders, and workflows. Enables: - Universal protocols (inherited by ALL users) - User-specific overrides and preferences - AI-type filtering (claude, local, gemini, gpt) - Session objectives display on init - Structured content support (dict/list, not just strings)
Tools (7 total)
| Tool | Description | Required Params |
|---|---|---|
init |
Returns all merged protocols | user, ai_type (optional) |
get |
Get specific section or item | section |
add |
Add new item to section | section, item, content |
update |
Update existing item | section, item, content |
delete |
Delete item from section | section, item |
list |
List all sections or items | section, scope (optional) |
section_create |
Create new section | section |
Scope Values
universal- Applies to all users (default for section_create)user- User-specific (default for add/update/delete)merged- User overrides universal (default for get)all- Show both (for list)
Architecture
Key Patterns
- Universal:
wflow:_universal:{section}:{item} - User:
wflow:{user}:{section}:{item} - Sections index:
wflow:{scope}:sections(set) - Items index:
wflow:{scope}:{section}:items(set)
Merge Behavior
User content overrides universal when keys match.
Database Stats
- Vault (6615) Keys: 204
- Universal Sections: 16
- User Sections: 20
Key Features
- Session Objectives: Displays hierarchical objectives on init (pending/in_progress/completed)
- Structured Content: Content can be string, dict, or list (v2.1.0)
- AI Type Filtering: Sections prefixed with
ai_filter by ai_type parameter - Override Indicators: ⚡ marks user overrides, [USER] marks user-only sections
Security Assessment
✅ Credentials retrieved via credentials_helper ✅ Fallback password only used if credentials_helper unavailable ✅ User ID resolved via user_helper for stable IDs ✅ No injection vulnerabilities
Test Results
✅ Redis 6615 (vault): Responding with 204 keys ✅ workflow.init: Returns comprehensive protocol dump ✅ workflow.list: Shows 16 universal + 20 user sections ⚠️ Port 6616 is empty (0 keys) - not configured as replica
Integration Points
- Session Helper: Loads objectives for workflow init display
- User Helper: Stable ID resolution (u_xxxx format)
- Credentials Helper: Secure password retrieval
Status: WORKING
Workflow environment fully operational. Port 6616 exists but is empty (vault/operational split not used for this environment).