How jay-teeyo/sdd-summary-mcp works
SDD Summary is an MCP-backed prompt-testing toolkit for Genesys Cloud Copilot/AI Studio summaries, used through Kiro or Cursor. The principal workflow is to authenticate, gather transcripts, define requirements and test cases, evaluate prompt versions, inspect reports, and iterate. The graph groups this workflow into MCP orchestration, Genesys integration, evaluation state, and reporting. Some subsystem connections are documented only at the product level; those are cited to the README rather than implying unobserved internal calls.
Main entry points: handlers.ts Workflow handlers · client.ts Genesys API client · build.ts Report construction · index.ts MCP server
Components 23
MCP orchestration
- MCP server
mcp-server/src/index.ts - Tool catalog
mcp-server/src/tools/definitions.ts - Workflow handlers
mcp-server/src/tools/handlers.ts - Pipeline guidance
mcp-server/src/pipelineGuide.ts - Host support
mcp-server/src/host.ts
Genesys integration
- OAuth and tokens
mcp-server/src/genesys/auth.ts - Genesys API client
mcp-server/src/genesys/client.ts - Conversation search
mcp-server/src/genesys/analytics.ts - Transcript retrieval
mcp-server/src/genesys/transcripts.ts - Summary prompts
mcp-server/src/genesys/summaries.ts - Copilot integration
mcp-server/src/genesys/copilot.ts
Evaluation workflow
- Project configuration
mcp-server/src/config.ts - Workspace data
mcp-server/src/storage.ts - Requirements, cases, evaluations
mcp-server/src/tools/handlers.ts
Reports and insights
- Report construction
mcp-server/src/reports/build.ts - Report model and metrics
mcp-server/src/reports/model.ts - Findings and diffs
mcp-server/src/reports/findings.ts - Run comparison
mcp-server/src/reports/diff.ts - HTML report rendering
mcp-server/src/reports/render.ts - Report views
mcp-server/src/reports/templates
Other components
- Engineer
- Kiro / Cursor
- Genesys Cloud
Connections 32
- Engineer → Kiro / Cursor: requests workflow
README.md - Kiro / Cursor → MCP server: invokes tools
README.md - MCP server → Tool catalog: loads definitions
mcp-server/src/index.ts - MCP server → Workflow handlers: dispatches tools
mcp-server/src/index.ts - MCP server → Pipeline guidance: provides guidance
mcp-server/src/index.ts - Pipeline guidance → Host support: uses host instructions
mcp-server/src/pipelineGuide.ts - Workflow handlers → OAuth and tokens: authenticates
mcp-server/src/tools/handlers.ts - Workflow handlers → Transcript retrieval: fetches transcripts
mcp-server/src/tools/handlers.ts - Workflow handlers → Summary prompts: previews summaries
mcp-server/src/tools/handlers.ts - Workflow handlers → Genesys API client: checks API scopes
mcp-server/src/tools/handlers.ts - Genesys API client → OAuth and tokens: gets access tokens
mcp-server/src/genesys/client.ts - Genesys API client → Genesys Cloud: sends API requests
mcp-server/src/genesys/client.ts - Conversation search → Genesys API client: queries API
mcp-server/src/genesys/analytics.ts - Transcript retrieval → Genesys API client: retrieves transcript data
mcp-server/src/genesys/transcripts.ts - Summary prompts → Genesys API client: uses API
mcp-server/src/genesys/summaries.ts - Copilot integration → Genesys API client: uses API
mcp-server/src/genesys/copilot.ts - Workflow handlers → Conversation search: searches conversations
mcp-server/src/tools/handlers.ts - Workflow handlers → Copilot integration: uses integration
mcp-server/src/tools/handlers.ts - Workflow handlers → Project configuration: loads configuration
mcp-server/src/tools/handlers.ts - Workflow handlers → Workspace data: reads and writes workflow data
mcp-server/src/tools/handlers.ts - Workflow handlers → Requirements, cases, evaluations: runs authoring and evaluation
README.md - Workflow handlers → Report construction: builds dashboards
mcp-server/src/tools/handlers.ts - Report construction → Workspace data: reads saved runs
mcp-server/src/reports/build.ts - Report construction → Report model and metrics: builds report data
mcp-server/src/reports/build.ts - Report construction → Run comparison: compares runs
mcp-server/src/reports/build.ts - Report construction → Findings and diffs: collects findings
mcp-server/src/reports/build.ts - HTML report rendering → Report model and metrics: renders report data
mcp-server/src/reports/render.ts - HTML report rendering → Report views: uses report views
- Engineer → Genesys Cloud: configures OAuth
README.md - Engineer → Requirements, cases, evaluations: authors and evaluates prompts
README.md - Requirements, cases, evaluations → Workspace data: persists evaluation state
mcp-server/src/tools/handlers.ts - Engineer → Report construction: reviews dashboards
README.md