AI-SDLC MCP Server

Lean & Focused MCP Server for AI-SDLC - X-Ray Scanner, Debug Agent, Document Access

🚀 Features

| Category | Tools | Description | |----------|-------|-------------| | X-Ray Scanner | 7 | Scan repos for code quality & security | | Debug Agent | 4 | Fix errors with AI diagnosis | | Document Access | 4 | Read projects & generated docs | | Chat & Compare | 2 | Ask questions about repos |

Total: 17 Tools | 4 Resources | 3 Prompts

📦 Installation

npm install -g aisdlc-mcp

Or use directly with npx:

npx aisdlc-mcp

⚙️ Configuration

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | AISDLC_API_KEY | ✅ Yes | - | Your AI-SDLC API key | | AISDLC_API_URL | No | https://backend.production.ai-sdlc.dev | API endpoint |

Get Your API Key

1. Go to AI-SDLC Dashboard
2. Navigate to Settings → API Keys
3. Generate a new MCP API key

🔧 IDE Setup

Cursor / Windsurf

Add to your MCP settings (~/.cursor/mcp.json or equivalent):

{
  "mcpServers": {
    "aisdlc": {
      "command": "npx",
      "args": ["-y", "aisdlc-mcp"],
      "env": {
        "AISDLC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "aisdlc": {
      "command": "npx",
      "args": ["-y", "aisdlc-mcp"],
      "env": {
        "AISDLC_API_KEY": "your-api-key-here"
      }
    }
  }
}

🛠️ Available Tools

X-Ray Repository Scanner (7 tools)

• xray_scan - Scan a GitHub/GitLab repository
• get_scan_history - Get all previous scans
• get_scan_result - Get details of a specific scan
• delete_scan - Delete a scan result
• compare_repos - Compare two repositories
• scan_vulnerabilities - Check for CVEs
• validate_repo_url - Validate a repo URL

Debug Agent (4 tools)

• debug_error - Analyze error with AI diagnosis
• debug_screenshot - Analyze error screenshot with Vision AI
• get_quick_diagnosis - Instant pattern-based diagnosis
• chat_project - Chat with AI about a project

Document Access (4 tools)

• list_projects - List all your projects
• get_project - Get project details
• get_document - Get a specific document
• get_all_documents - Get all project documents

Chat & Utility (2 tools)

• chat_comparison - Ask questions comparing two repos
• health_check - Check API health status

📚 Available Resources

• aisdlc://projects - All user projects
• aisdlc://scans - All X-Ray scans
• aisdlc://doc-types - Available document types
• aisdlc://platforms - Supported platforms (GitHub, GitLab)

🎯 Available Prompts

• analyze_repository - Full repo analysis workflow
• compare_repositories - Compare two repos workflow
• debug_error_workflow - Complete error debugging workflow

📄 Document Types

| Type | Description | |------|-------------| | project_requirements | Project Requirements (PRD) | | app_flow | Application Flow | | tech_stack | Tech Stack | | frontend_guidelines | Frontend Guidelines | | backend_structure | Backend Structure | | security_guidelines | Security Guidelines | | implementation_plan | Implementation Plan | | app_flowchart | Application Flowchart (PlantUML) | | setup_guide | Setup Guide | | project_prompt_playbook | Project Prompt Playbook | | test_cases | Test Cases |

🏗️ Development

# Clone the repository
git clone https://github.com/ai-sdlc/mcp-aisdlc.git
cd mcp-aisdlc

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

📝 License

MIT License - see LICENSE file for details.

🔗 Links

• AI-SDLC Website
• Documentation
• Dashboard
• Support

Note: Project creation, document generation, and billing features are only available on the AI-SDLC website for better UX with streaming and progress indicators.