Track Environment
Environment Configuration
- Vault Port: 6640 (MASTER - writes)
- Operational Port: 6641 (reads, no password required)
- Locker ID: l_f3a8
- Vault Password: Retrieved via credentials_helper (l_23c3)
Purpose
Track MCP Server provides project and task management for Nexus. It enables: - Creating and managing projects with hierarchy (parent/subproject) - Adding tasks to projects with status tracking (pending/active/completed) - Linking Nexus references to tasks and projects - Auto-calculating project progress based on task completion - Session integration (two-birds-one-stone linking) - FalkorDB Layer 3 graph indexing - Quadfecta relevance scoring for search
Architecture
- Server Version: 1.3.0 (Multi-tenant key patterns)
- Key Patterns:
- NEW:
track:project:{stable_id}(p_xxxx format) - NEW:
track:task:{stable_id}(t_xxxx format) - LEGACY:
track:{user}:{timestamp}:project:{uuid} - LEGACY:
track:{user}:{timestamp}:task:{uuid} - Global indexes:
track:projects(set),track:tasks(set) - User index:
track:{user}:projects(set)
Database Stats
- Total Keys in Vault (6640): 2,436
- Total Keys in Operational (6641): 2,241
- Projects: 167
- Tasks: 2,262
- User u_z1p5 projects: 171
Tools Reference (14 tools)
| Tool | Description | Required Params |
|---|---|---|
create |
Create new project track | title |
get |
Get project details with tasks | project_id |
list |
List projects filtered by status | (optional: status, query) |
update |
Update project status/title | project_id |
add_task |
Add task to project | project_id, title |
update_task |
Update task status | task_id, status |
link_reference |
Add Nexus reference to task | task_id, reference |
link_references_batch |
Add multiple task references | task_id, references[] |
link_project_reference |
Add reference to PROJECT | project_id, reference |
link_project_references_batch |
Add multiple project refs | project_id, references[] |
delete |
Delete project or task | project_id OR task_id |
add_tasks_batch |
Add multiple tasks at once | project_id, tasks[] |
update_tasks_batch |
Update multiple task statuses | updates[] |
dashboard |
Pre-formatted project dashboard | (optional: status, days) |
Status Values
- Projects: active, on_hold, completed, reference, replaced
- Tasks: pending, active, completed
Security Assessment
✅ Credentials retrieved via credentials_helper (no hardcoded passwords in server code) ✅ Fallback password only used if credentials_helper unavailable ✅ User ID resolved via user_helper for stable IDs ✅ No apparent injection vulnerabilities - uses parameterized JSON storage ⚠️ Note: Operational port 6641 has no password (read replica design)
Test Results
✅ track.list - Returns 52 active projects ✅ track.get - Project 365f4483 retrieved successfully (14% progress, 7 tasks) ✅ Redis replication: Both ports are MASTER (connected_slaves:0) - NOT replicated ⚠️ Vault (6640) and Operational (6641) are independent databases, not replica pair
Integration Points
- Session Helper: Links items to current session automatically
- Graph Helper: Indexes projects in FalkorDB for Layer 3
- Quadfecta: Keyword + temporal scoring for search results
- User Helper: Stable ID resolution (u_xxxx format)
Status: WORKING
Track environment is fully operational with secure credential management.