Skip to content

PRD: MCP Integration with Kiro

Project: ai-plans Date: 2026-02-08 Status: approved

Context

Integrate the ai-plans MCP server with Kiro (opencode) to enable AI agents to automatically publish PRDs, tasks, and track progress through a static documentation site.

Goals

  • Enable AI agents to create and manage project documentation
  • Provide a centralized place for PRDs and task tracking
  • Auto-generate static site with MkDocs Material
  • Integrate with git workflow for version control

Requirements

Functional

  • MCP server with 6 tools (publish_prd, publish_tasks, update_task_status, publish_notes, get_plan_link, list_plans)
  • Automatic git commits for documentation changes
  • MkDocs Material site generation
  • Auto-update index page with project list
  • Integration with Kiro MCP configuration
  • Test workflow with real project

Non-functional

  • Fast response time (<1s for file operations)
  • Reliable git operations
  • Clean markdown output

Technical Approach

  1. TypeScript MCP server using @modelcontextprotocol/sdk
  2. simple-git for git operations
  3. MkDocs Material in Docker for site generation
  4. Stdio transport for MCP communication
  5. Environment variables for configuration

Constraints and Risks

  • Requires Docker for MkDocs
  • Git must be configured
  • File system permissions
  • MkDocs watch mode may not pick up changes immediately

Open Questions

  • Should we auto-push to remote by default?
  • How to handle concurrent edits?