MCP Server Best Practices

{
  "initrepo": {
    "performance": {
      "cacheEnabled": true,
      "maxConcurrency": 10,
      "timeout": 30000
    },
    "analysis": {
      "depth": "comprehensive",
      "includeDependencies": true,
      "validateReferences": true
    },
    "integrations": {
      "github": true,
      "slack": true,
      "jira": true
    }
  }
}

project-root/
├── README.md                    # Project overview with tasks
├── docs/
│   ├── business_analysis.md     # Business requirements
│   ├── prd.md                   # Product requirements
│   ├── technical_architecture.md # Technical specifications
│   ├── user_stories.md          # User stories and epics
│   ├── ux_ui_design.md          # UI/UX specifications
│   └── [other specialized docs]
└── .initrepo/                   # Generated analysis files
    ├── project-structure.md
    └── tech-stack.md

# Specific and actionable
"Generate implementation brief for T-001 with dependencies"

# Context-aware
"What are the blocking dependencies for US-005?"

# Analysis-focused
"Analyze the technical risks for the authentication system"

# Validation-oriented
"Validate that all requirements for E-002 are covered"

# Start your development session
initrepo-mcp query "getPrioritizedTasks"

# Get context for today's focus
initrepo-mcp query "getContext T-007 --include-dependencies"

# Review project progress
initrepo-mcp query "generateProgressReport --scope=current-sprint"

# Generate implementation guidance
initrepo-mcp query "generateImplementationBrief T-012"

# Validate against requirements
initrepo-mcp query "validateRequirements T-012"

# Check for blocking dependencies
initrepo-mcp query "analyzeDependencies T-012"

# Generate review context
initrepo-mcp query "getImplementationContext T-012"

# Validate completeness
initrepo-mcp query "validateCompleteness T-012"

# Check architectural compliance
initrepo-mcp query "analyzeArchitecturalImpact T-012"

# Epic overview
initrepo-mcp query "getEpicOverview E-001"

# Task breakdown and estimation
initrepo-mcp query "breakdownTasks E-001"

# Dependency mapping
initrepo-mcp query "mapDependencies E-001"

# Capacity planning
initrepo-mcp query "calculateCapacity current-sprint"

# Individual progress
initrepo-mcp query "getMyProgress yesterday"

# Team blockers
initrepo-mcp query "identifyBlockers team"

# Sprint progress
initrepo-mcp query "getSprintProgress"

# CI/CD Pipeline Integration
name: Quality Assurance
on: [pull_request]

jobs:
  quality-check:
    runs-on: ubuntu-latest
    steps:
      - name: Validate Documentation
        run: initrepo-mcp validate-docs

      - name: Check Completeness
        run: initrepo-mcp validate-completeness

      - name: Analyze Dependencies
        run: initrepo-mcp analyze-dependencies

# Pre-review validation
initrepo-mcp query "validateImplementation T-012"
initrepo-mcp query "checkStandards T-012"
initrepo-mcp query "analyzeImpact T-012"

# Generate review checklist
initrepo-mcp query "generateReviewChecklist T-012"

// development.json
{
  "analysis": {
    "depth": "detailed",
    "caching": false,
    "logging": "debug"
  },
  "integrations": {
    "slack": false,
    "jira": false
  }
}

// production.json
{
  "analysis": {
    "depth": "comprehensive",
    "caching": true,
    "logging": "info"
  },
  "integrations": {
    "slack": true,
    "jira": true,
    "monitoring": true
  }
}

// .initrepo/team-config.json
{
  "standards": {
    "codeStyle": "eslint-config-airbnb",
    "testing": "jest",
    "documentation": "markdown",
    "branching": "git-flow"
  },
  "workflows": {
    "codeReview": "required",
    "testing": "required",
    "documentation": "required"
  },
  "integrations": {
    "slack": "#dev-team",
    "jira": "DEV",
    "github": "initrepo/dev-team"
  }
}

# Enable detailed logging
export INITREPO_LOG_LEVEL=debug
export INITREPO_METRICS_ENABLED=true

# Monitor key metrics
initrepo-mcp query "getPerformanceMetrics"
initrepo-mcp query "getUsageAnalytics"
initrepo-mcp query "getErrorRates"

#!/bin/bash
# Daily health check script

# Check server connectivity
if ! curl -f https://mcp.initrepo.com/health; then
    echo "Server health check failed"
    exit 1
fi

# Validate configuration
if ! initrepo-mcp validate-config; then
    echo "Configuration validation failed"
    exit 1
fi

# Check documentation completeness
if ! initrepo-mcp validate-docs --quiet; then
    echo "Documentation validation failed"
    exit 1
fi

echo "All health checks passed"

{
  "security": {
    "authentication": "oauth2",
    "mfa": true,
    "sessionTimeout": 3600,
    "auditLogging": true
  },
  "permissions": {
    "developers": ["read", "analyze", "modify"],
    "leads": ["read", "analyze", "modify", "admin"],
    "viewers": ["read"]
  }
}

{
  "performance": {
    "caching": {
      "enabled": true,
      "ttl": 3600,
      "maxSize": "2GB"
    },
    "concurrency": {
      "maxWorkers": 10,
      "queueSize": 100
    },
    "optimization": {
      "incrementalAnalysis": true,
      "backgroundProcessing": true,
      "smartInvalidation": true
    }
  }
}

name: InitRepo MCP Analysis
on: [push, pull_request]

jobs:
  mcp-analysis:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '18'

      - name: Install InitRepo MCP
        run: npm install -g initrepo-mcp

      - name: Validate Documentation Completeness
        run: |
          initrepo-mcp validateDocumentationCompleteness > validation.json
          cat validation.json

      - name: Generate Implementation Brief
        run: |
          initrepo-mcp generateSmartImplementationBrief --taskId T-001 > brief.md
          cat brief.md

pipeline {
    agent any

    stages {
        stage('MCP Analysis') {
            steps {
                sh 'npm install -g initrepo-mcp'

                sh 'initrepo-mcp validateDocumentationCompleteness > validation.json'

                sh 'initrepo-mcp generateProgressReport > progress.md'

                archiveArtifacts artifacts: '*.json,*.md', fingerprint: true
            }
        }
    }

    post {
        always {
            publishHTML(target: [
                allowMissing: false,
                alwaysLinkToLastBuild: true,
                keepAll: true,
                reportDir: '.',
                reportFiles: 'validation.json,progress.md',
                reportName: 'MCP Analysis'
            ])
        }
    }
}

<!-- Standard task documentation template -->
# Task: [T-XXX] Brief Description

## Overview
[Brief task description and business value]

## Requirements
- [ ] Requirement 1
- [ ] Requirement 2
- [ ] Requirement 3

## Implementation
[Technical approach and considerations]

## Dependencies
- Blocks: [T-XXX], [T-YYY]
- Blocked by: [T-ZZZ]

## Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2

## Testing
[Testing approach and scenarios]