DevOps导师服务

flowchart TD
    Client["MCP Client (IDE / Claude)"] -->|MCP protocol| Server["MCP DevOps Mentor Server<br/>(FastAPI + FastMCP, Docker)"]
    Server --> Brain["Mentor Brain<br/>system prompt + 4 modes"]
    Server --> Repo["Repo Analyzer<br/>stack detection, maturity scoring"]
    Server --> CICD["CI/CD Review Engine<br/>GitHub Actions YAML"]
    Server --> TF["Terraform Review Engine<br/>HCL2 parsing, security, state"]
    Server --> AWS["AWS Advisor<br/>cost + security posture"]
    Server --> Enhancer["Prompt Enhancer<br/>domain detection, skill-aware"]
    Server --> Tracker["Skill Tracker<br/>weighted scoring, SQLite"]
    Repo & CICD & TF & AWS -->|read-only token| GitHub[("GitHub API")]

enhance_prompt(
    prompt="Set up a CI/CD pipeline for my Python app",
    mode="mentor",           # optional, defaults to current mode
    cloud_provider="aws",    # optional, auto-detected or defaults to AWS
    focus_areas="security"   # optional, comma-separated dimension filter
)

<context>
Cloud provider context: AWS. ...
Domains: ci_cd
User experience level: beginner
Response detail: detailed
</context>

<instructions>
You are helping a DevOps learner understand and implement the following. ...
</instructions>

<task>
Set up a CI/CD pipeline for my Python app
</task>

<additional_considerations>
- Consider security implications: action pinning, least-privilege permissions...
- Include a rollback strategy: how to revert a failed deployment safely.
- Address build performance: dependency caching, artifact reuse...
- Include testing requirements: what tests to run, coverage thresholds...
</additional_considerations>

<thinking>
Think through this step by step, explaining your reasoning at each stage.
</thinking>

<output_format>
Structure your response as:
1. Conceptual explanation (the WHY)
2. Implementation approach (the HOW)
3. Common pitfalls to avoid
4. Next steps for learning
</output_format>

export GITHUB_TOKEN=ghp_your_token_here
docker-compose up --build

pip install -r requirements.txt
export GITHUB_TOKEN=ghp_your_token_here
uvicorn main:app --host 0.0.0.0 --port 3333

pip install -r requirements.txt
pytest tests/ -v

MCP-DevOps-Mentor/
  main.py                           # FastAPI + MCP server, tool registration
  requirements.txt                  # Dependencies
  Dockerfile                        # Python 3.11-slim container
  docker-compose.yml                # Single-service deployment
  analyzer/
    repo_analyzer.py                # Tech stack detection and maturity scoring
  reviewers/
    cicd_reviewer.py                # GitHub Actions review (YAML parsing)
    terraform_reviewer.py           # Terraform review (HCL2 parsing)
    aws_advisor.py                  # AWS cost + security advisor
  tools/
    github.py                       # GitHub REST API integration
  enhancer/
    prompt_enhancer.py              # 6-stage prompt enhancement pipeline
    domain_rules.py                 # Domain keywords, dimension injections, templates
    skill_adapter.py                # Skill-level to enhancement behavior bridge
  memory/
    models.py                       # SkillState, UserProfile dataclasses
    store.py                        # SQLite persistence
    tracker.py                      # Weighted skill tracking + learning path
  mentor/
    system_prompt.txt               # Base mentor persona
    mode_loader.py                  # Dynamic prompt composition
    modes/
      mentor.txt                    # Teaching mode prompt
      review.txt                    # PR review mode prompt
      debug.txt                     # Troubleshooting mode prompt
      interview.txt                 # Challenge mode prompt
  tests/
    conftest.py                     # Shared fixtures (tmp_db, sample data)
    test_repo_analyzer.py           # 10 tests
    test_cicd_reviewer.py           # 15 tests
    test_terraform_reviewer.py      # 15 tests
    test_aws_advisor.py             # 11 tests
    test_tracker.py                 # 17 tests
    test_store.py                   # 5 tests
    test_mode_loader.py             # 8 tests
    test_prompt_enhancer.py         # 38 tests
    test_domain_rules.py            # 10 tests
    test_skill_adapter.py           # 10 tests

> "Analyze my repo and tell me its DevOps maturity."

> "Switch to review mode and review my CI/CD pipeline."

> "Review the Terraform files in my infrastructure repo."

> "What are my weakest DevOps skills? Give me a learning path."

> "Switch to interview mode. Challenge my system design."

> "Enhance my prompt: Set up a CI/CD pipeline for my Python app"

> "Enhance this prompt with a focus on security: Deploy containers to ECS with Terraform"