Verify MCP configuration and provide setup guidance
Verifies MCP server configuration and provides tier-based setup guidance with domain analysis.
/plugin marketplace add krzemienski/shannon-framework/plugin install shannon@shannon-frameworkVerifies MCP server availability and provides detailed setup guidance through delegation to the mcp-discovery skill. Uses quantitative domain analysis to recommend appropriate MCPs with tier-based prioritization.
None (this command helps establish prerequisites)
Parse command arguments:
Check Types:
--install-guide → Show only installation instructions--fix → Interactive setup assistance--serena-only → Check only critical Serena MCPIf project context exists, estimate domain breakdown:
Domain Estimation:
IF project files accessible:
- Count frontend files (React, Vue, etc.) → Frontend %
- Count backend files (Express, FastAPI, etc.) → Backend %
- Count database files (migrations, queries) → Database %
ELSE:
- Use generic recommendations (Serena mandatory, common secondaries)
Delegate to @skill mcp-discovery for recommendations:
For Full Check:
@skill mcp-discovery
- Input:
* mode: "recommend"
* domain_breakdown: {
frontend: {frontend_percentage},
backend: {backend_percentage},
database: {database_percentage}
}
* include_health_checks: true
* include_setup_guide: true
- Output: mcp_recommendations
For Health Check:
@skill mcp-discovery
- Input:
* mode: "health_check"
* recommended_mcps: {mcps from domain analysis}
- Output: health_status
For Fallback Recommendations:
@skill mcp-discovery
- Input:
* mode: "fallback"
* unavailable_mcp: "{mcp_name}"
- Output: fallback_chain
Format skill output for user display:
═══════════════════════════════════════════════════════════════
🔍 SHANNON MCP SERVER VERIFICATION
═══════════════════════════════════════════════════════════════
🔴 TIER 1: MANDATORY SERVERS
───────────────────────────────────────────────────────────────
{for each mandatory MCP}
{if operational}
✅ {mcp_name} - CONNECTED
Version: {version}
Status: Operational
Tools Available: {tools_list}
{else}
❌ {mcp_name} - NOT FOUND
Status: CRITICAL - Shannon cannot function without {mcp_name}
Purpose: {purpose}
📦 Installation:
{installation_command}
⚙️ Configuration:
{configuration_json}
✓ Verification:
{health_check_command}
📚 Documentation:
{documentation_url}
{end if}
{end for}
🟡 TIER 2: PRIMARY SERVERS
───────────────────────────────────────────────────────────────
{for each primary MCP}
{if operational}
✅ {mcp_name} - CONNECTED
Rationale: {domain} {percentage}% >= 20% threshold
Status: Operational
Tools Available: {tools_list}
{else}
⚠️ {mcp_name} - NOT FOUND
Status: Recommended - {purpose}
Rationale: {domain} {percentage}% >= 20% threshold
Impact: {impact_description}
📦 Installation:
{installation_command}
⚙️ Configuration:
{configuration_json}
🔄 Fallback Chain:
{fallback_chain}
📚 Documentation:
{documentation_url}
{end if}
{end for}
🟢 TIER 3: SECONDARY SERVERS
───────────────────────────────────────────────────────────────
{for each secondary MCP}
{status and details similar to primary}
{end for}
───────────────────────────────────────────────────────────────
📊 SUMMARY
───────────────────────────────────────────────────────────────
Required: {mandatory_available}/{mandatory_total} available
Primary: {primary_available}/{primary_total} available
Secondary: {secondary_available}/{secondary_total} available
{if any mandatory missing}
🚨 CRITICAL: {missing_mandatory_list} must be configured
{else if any primary missing}
⚠️ FUNCTIONAL: {missing_primary_list} recommended for best experience
{else}
✅ ALL SYSTEMS OPERATIONAL
{end if}
💡 After configuring MCPs, run /shannon:\1 to verify full Shannon functionality
═══════════════════════════════════════════════════════════════
Based on health check results:
If Serena Missing (Critical):
🚨 IMMEDIATE ACTION REQUIRED
Serena MCP is MANDATORY for Shannon Framework.
**Quick Setup**:
1. Install: {installation_command}
2. Configure: Add to Claude Code settings
3. Restart: Claude Code
4. Verify: /shannon:check_mcps
Without Serena, Shannon commands will fail.
If Primary MCPs Missing:
⚠️ RECOMMENDED SETUP
Missing Primary MCPs affect core functionality:
{for each missing primary}
- {mcp_name}: {purpose}
Impact: {impact_description}
{end for}
Setup Order:
1. Install missing Primary MCPs
2. Verify each: {health_check_command}
3. Confirm: /shannon:check_mcps
V3 Compatibility: ✅ Maintained
Changes from V3:
None (this command helps establish MCP dependencies)
Issue: "Tool not found" errors
Issue: "Serena connection failed"
Issue: "Threshold gaming" (Frontend 19.9%)