Skip to main content
Glama

VibeOps MCP

VibeOps MCP

A contract-based product organization system that enforces structured planning and validation for product development.

Overview

VibeOps MCP organizes product development work into a clear hierarchy with enforced contracts at each level:

๐Ÿ“ฆ MODULE (Theme/Initiative) โ””โ”€ ๐Ÿ“‹ FEATURE (with PRD contract) โ””โ”€ ๐Ÿ“ ISSUES (with type-specific contracts) โ”œโ”€ User Story (acceptance criteria, DoD, DoR) โ”œโ”€ Bug (repro steps, environment) โ”œโ”€ Tech Debt (impact, effort) โ””โ”€ Spike (questions, timebox)

Getting Started

Installation

npm install

Using Templates

Templates are provided for each work item type in contracts/templates/:

# Copy a template cp contracts/templates/module.template.json modules/my-module.json # Edit with your details # ... # Validate the contract npm run validate:module modules/my-module.json

Contract Validation

Every work item must pass validation against its JSON schema before being considered valid.

Validation Commands

# Validate individual contract types npm run validate:module path/to/module.json npm run validate:feature path/to/feature.json npm run validate:story path/to/user-story.json npm run validate:bug path/to/bug.json npm run validate:debt path/to/tech-debt.json npm run validate:spike path/to/spike.json

Working with Claude Code

When using Claude Code with this repository:

  1. Ask Claude to create work items: "Create a module for user authentication"

  2. Claude will use the templates and validate contracts automatically

  3. You'll receive validated JSON contracts that conform to the schemas

See CLAUDE.md for detailed guidance on how Claude Code works with this system.

Directory Structure

vibeops-mcp/ โ”œโ”€โ”€ contracts/ โ”‚ โ”œโ”€โ”€ schemas/ # JSON Schema definitions โ”‚ โ”œโ”€โ”€ templates/ # Template files for each type โ”‚ โ””โ”€โ”€ validators/ # Contract validation logic โ”œโ”€โ”€ mcp/ # MCP server implementation โ”œโ”€โ”€ CLAUDE.md # Guidance for Claude Code โ”œโ”€โ”€ README.md # This file โ””โ”€โ”€ package.json # Project dependencies and scripts

Contract Requirements Summary

  • MODULE: Must have unique ID (MOD-####), name, description, type, status

  • FEATURE: Must have PRD contract with problem statement, goals, success metrics, scope

  • USER STORY: Must have acceptance criteria, Definition of Done, Definition of Ready

  • BUG: Must have reproduction steps with expected/actual results, environment details

  • TECH DEBT: Must have impact assessment and effort estimation

  • SPIKE: Must have research questions and timebox

See CLAUDE.md for complete contract specifications.

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enforces structured product development through contract-based validation of modules, features, and issues with type-specific requirements (user stories, bugs, tech debt, spikes) using JSON schemas.

  1. Overview
    1. Getting Started
      1. Installation
      2. Using Templates
    2. Contract Validation
      1. Validation Commands
      2. Working with Claude Code
    3. Directory Structure
      1. Contract Requirements Summary

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/meetronwilson/vibeops-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server