Product Management MCP Server

Minimal, KISS-first MCP server that manages documents (PRDs/TDDs/ADRs), epics, user stories, and tasks via a SQLite backend.

Install

pip install -r requirements.txt

Run

# STDIO transport
python server.py

# HTTP transport (Docker default)
python server.py --http

Key Prompts

• kiss_principle_check_prompt — Outputs a KISS audit workflow.
• project_prd_request — Generates PRD content from a description.
• feature_request_prompt — Generates a feature task list.
• process_task_prompt — Guides task execution protocol.

Tools & Resources

• Resources:

  • docs://index — List all documents
  • docs://type/{doc_type} — List documents by type
  • doc://{id} — Read full document (hierarchically sorted)
  • doc://{id}/sections/{name} — Read one section

• Tools:

  • create_doc(title, sections, doc_type) → returns typed CreateDocResponse
  • edit_doc(id, target_section, operation, content?) → returns typed EditDocResult
  • read_doc(id, section?) → returns DocumentResponse or single SectionResponse
  • create_ticket(...) → create epic, user-story, task

All tool/resource outputs are standardized Pydantic models serialized via .model_dump().

Configuration

Centralized in config.py:

• database_path: path to SQLite DB file (default: project.db in CWD)

Architecture

• server.py — MCP prompts, tools, and resources
• sqlite.py — SQLite storage implementation
• dto.py — Input and response models (Pydantic)
• models.py — Dataclass DTOs for domain storage
• protocols.py — Storage protocols
• templates.py — Prompt templates

Docker

docker compose up --build

Exposes HTTP on port 8000.

Notes

• Keep changes small and incremental.
• Prefer deletions and consolidation over abstraction.
• Typed outputs via Pydantic for predictability.

tracker