sds-mcp

SDS MCP - Structured Development Specification Model Context Protocol server for automated project analysis and specification generation

Features

• 🔍 Project Analysis - Automated analysis of project structure and dependencies
• 📋 Specification Generation - Generate comprehensive development specifications
• 🔄 Multiple Export Formats - Support for JSON, YAML, XML, CSV, HTML, and Markdown
• 🤖 AI Integration - Powered by OpenAI and Anthropic models
• 🚀 MCP Protocol - Native Model Context Protocol support for Claude Code
• 🔒 Security - Built-in security validation and rate limiting
• 📊 Performance Monitoring - Real-time metrics and optimization

Installation

Global Installation (Recommended)

# Using npm
npm install -g sds-mcp

# Using the installation script
curl -fsSL https://raw.githubusercontent.com/salwks/sdsmcp/main/scripts/install.sh | bash

# For Windows PowerShell
iwr https://raw.githubusercontent.com/salwks/sdsmcp/main/scripts/install.ps1 | iex

Local Installation

# Clone repository
git clone https://github.com/salwks/sds-mcp.git
cd sdsmcp

# Install dependencies
npm install

# Run locally
npm start

Quick Start

1. Start the Server

# Global installation
sdsmcp start

# Local installation  
npx sdsmcp start

2. Setup Claude Code Integration

# Setup for your project
sdsmcp setup --directory /path/to/your/project

# Verify installation
sdsmcp verify

3. Use with Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "sdsmcp": {
      "command": "sdsmcp",
      "args": ["start"],
      "env": {
        "NODE_ENV": "development"
      }
    }
  }
}

Usage

Available Tools

• analyze_project - Analyze project structure and generate specifications
• export_specification - Export specifications in multiple formats
• validate_structure - Validate project against best practices
• generate_documentation - Auto-generate project documentation

Command Line Interface

# Start server
sdsmcp start [options]

# Setup Claude integration
sdsmcp setup [options]

# Verify installation
sdsmcp verify [options]

# Show version
sdsmcp version

Configuration

See Configuration Guide for detailed setup options.

Documentation

• API Documentation
• Installation Guide
• Configuration Guide
• Troubleshooting

Development

# Clone repository
git clone https://github.com/salwks/sds-mcp.git
cd sdsmcp

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Run linting
npm run lint

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests and linting
5. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• 📚 Documentation
• 🐛 Issue Tracker
• 💬 Discussions

Changelog

See CHANGELOG.md for version history.