docs: Add user-facing documentation for MCP Evaluation Framework (PR 1377)

[rysweet]

Problem

PR 1377 introduced a Generic MCP Evaluation Framework but lacks user-facing documentation in the docs/ directory. Current documentation is framework-internal (in tests/mcp_evaluation/) and technical specs (in Specs/).

Requirements

Create comprehensive user-facing documentation:

1. MCP Evaluation Guide (docs/MCP_EVALUATION_GUIDE.md)

• Audience: amplihack users evaluating MCP integrations
• Content:
  • What is MCP evaluation and why use it
  • When to evaluate (decision criteria)
  • Quick start with mock adapter
  • Evaluating real MCP tools
  • Interpreting results and making decisions
  • Troubleshooting

2. Adapter Creation Guide (docs/MCP_ADAPTER_CREATION.md)

• Audience: Developers adding new MCP tool evaluations
• Content:
  • Adapter interface requirements
  • Configuration file format
  • Metrics collection patterns
  • Testing adapters
  • Real example walkthrough
  • Common patterns

3. README Update

Add feature section linking to MCP Evaluation Guide after line 103

Success Criteria

• User can understand when to use MCP evaluation
• User can run mock evaluation in < 5 minutes
• User can interpret results and make integration decisions
• Developer can create custom adapter in < 30 minutes
• No need to read framework internals to use it

Related

• PR feat: Generic MCP evaluation framework #1377: Generic MCP evaluation framework

Labels

• documentation
• enhancement