How amirwebd3v/flowcv-mcp works
FlowCV MCP Server + CLI lets a user or AI assistant manage FlowCV resumes and related work through FlowCV’s session-cookie-authenticated API. The CLI routes commands to domain handlers; those handlers call the shared API client. The MCP server is a separate tool interface over that client. Authentication obtains and persists a session cookie. The README documents broad capabilities, but the MCP server implementation and most command handlers were not excerpted, so those branches rely on documented capabilities and indexed module references rather than detailed inspection.
Main entry points: cli.ts CLI Router · api-client.ts FlowCV API Client · auth-flow.ts Login Flow · index.ts MCP Tools
Components 21
User Interfaces
- CLI Router
src/cli.ts - MCP Tools
src/index.ts - CLI Output
src/cli/output.ts
Resume Workflows
- Resume Management
src/cli/commands/resume.ts - Resume Content
src/cli/commands/entry.ts - Section Settings
src/cli/commands/section.ts - Personal Details
src/cli/commands/personal.ts - Design Customization
src/cli/commands/design.ts - Template Operations
src/cli/commands/template.ts - Cover Letters
src/cli/commands/letter.ts
Account and Extensions
- AI Features
src/cli/commands/ai.ts - Publishing
src/cli/commands/publish.ts - Job Tracker
src/cli/commands/tracker.ts - Image Search
src/cli/commands/image.ts
Authentication and API
- Auth Commands
src/cli/commands/auth.ts - Login Flow
src/cli/auth-flow.ts - CLI Config
src/cli/config.ts - Workspace Config
src/mcp-config.ts - FlowCV API Client
src/api-client.ts
Other components
- User / Assistant
- FlowCV Service
Connections 33
- User / Assistant → CLI Router: runs commands
README.md - User / Assistant → MCP Tools: uses tools
README.md - CLI Router → Resume Management: dispatches
src/cli.ts - CLI Router → Resume Content: dispatches
src/cli.ts - CLI Router → Section Settings: dispatches
src/cli.ts - CLI Router → Personal Details: dispatches
src/cli.ts - CLI Router → Design Customization: dispatches
src/cli.ts - CLI Router → Template Operations: dispatches
src/cli.ts - CLI Router → Cover Letters: dispatches
src/cli.ts - CLI Router → AI Features: dispatches
src/cli.ts - CLI Router → Publishing: dispatches
src/cli.ts - CLI Router → Job Tracker: dispatches
src/cli.ts - CLI Router → Image Search: dispatches
src/cli.ts - CLI Router → Auth Commands: dispatches
src/cli.ts - CLI Router → CLI Output: formats output
src/cli.ts - Auth Commands → Login Flow: starts login
src/cli/commands/auth.ts - Login Flow → CLI Config: saves cookie
src/cli/auth-flow.ts - Login Flow → FlowCV API Client: verifies session
src/cli/auth-flow.ts - CLI Config → Workspace Config: reads workspace cookie
src/cli/config.ts - FlowCV API Client → Workspace Config: persists cookie
src/api-client.ts - MCP Tools → FlowCV API Client: calls
src/index.ts - Resume Management → FlowCV API Client: requests data
src/cli/commands/resume.ts - Resume Content → FlowCV API Client: reads and writes
src/cli/commands/entry.ts - Section Settings → FlowCV API Client: updates sections
src/cli/commands/section.ts - Personal Details → FlowCV API Client: updates details
src/cli/commands/personal.ts - Design Customization → FlowCV API Client: updates design
src/cli/commands/design.ts - Template Operations → FlowCV API Client: requests templates
src/cli/commands/template.ts - Cover Letters → FlowCV API Client: manages letters
src/cli/commands/letter.ts - AI Features → FlowCV API Client: requests AI
src/cli/commands/ai.ts - Publishing → FlowCV API Client: publishes resumes
src/cli/commands/publish.ts - Job Tracker → FlowCV API Client: manages applications
src/cli/commands/tracker.ts - Image Search → FlowCV API Client: searches images
src/cli/commands/image.ts - FlowCV API Client → FlowCV Service: sends API requests
src/api-client.ts