#!/bin/sh
set -e
# SpecLinter MCP Server Docker Entrypoint
# Handles different modes: serve, validate, init, help
# Colors for output
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
PURPLE='\033[0;35m'
CYAN='\033[0;36m'
NC='\033[0m' # No Color
# ASCII Art Logo
print_logo() {
echo "${PURPLE}"
echo " _____ ____ ___________ ____ ___ ____________ "
echo " / ___// __ \/ ____/ ___/ / __ \/ _ \/_ __/ ____/ "
echo " \__ \/ /_/ / __/ / /__ / / / / __/ / / / __/ "
echo " ___/ / ____/ /___/ /__/ / /_/ / / / / / /___ "
echo "/____/_/ /_____/\___/ /_____/_/ /_/ /_____/ "
echo "${NC}"
echo "${CYAN}🤖 AI-Powered Specification Analysis & Task Generation${NC}"
echo ""
}
# Print usage information
print_usage() {
echo "${GREEN}SpecLinter MCP Server - Docker Usage${NC}"
echo ""
echo "${YELLOW}Available Commands:${NC}"
echo " ${BLUE}serve${NC} - Start MCP server (default)"
echo " ${BLUE}init${NC} - Initialize SpecLinter in current directory"
echo " ${BLUE}validate${NC} - Run headless validation on existing features"
echo " ${BLUE}status${NC} - Show status of features"
echo " ${BLUE}help${NC} - Show this help message"
echo ""
echo "${YELLOW}Quick Start Examples:${NC}"
echo ""
echo "${CYAN}1. Try SpecLinter (temporary):${NC}"
echo " docker run -it --rm speclinter/mcp:latest"
echo ""
echo "${CYAN}2. Use with your project (persistent):${NC}"
echo " docker run -it --rm -v \$(pwd):/workspace speclinter/mcp:latest"
echo ""
echo "${CYAN}3. Initialize in your project:${NC}"
echo " docker run --rm -v \$(pwd):/workspace speclinter/mcp:latest init"
echo ""
echo "${CYAN}4. Validate existing specifications:${NC}"
echo " docker run --rm -v \$(pwd):/workspace speclinter/mcp:latest validate"
echo ""
echo "${YELLOW}MCP Configuration for AI IDEs:${NC}"
echo "${GREEN}Add this to your AI IDE's MCP configuration:${NC}"
echo ""
echo '{'
echo ' "mcpServers": {'
echo ' "speclinter": {'
echo ' "command": "docker",'
echo ' "args": ["run", "--rm", "-i", "-v", "$(pwd):/workspace",'
echo ' "speclinter/mcp:latest", "serve"]'
echo ' }'
echo ' }'
echo '}'
echo ""
}
# Initialize SpecLinter in the workspace
init_speclinter() {
echo "${GREEN}🚀 Initializing SpecLinter in workspace...${NC}"
if [ -d "/workspace/.speclinter" ]; then
echo "${YELLOW}⚠️ SpecLinter already initialized in this directory${NC}"
echo "${BLUE}📁 Found existing .speclinter directory${NC}"
else
echo "${BLUE}📁 Creating SpecLinter directories...${NC}"
node /app/dist/cli.js init 2>/dev/null || {
echo "${RED}❌ Failed to initialize SpecLinter${NC}"
echo "${YELLOW}💡 Make sure you have write permissions to the workspace${NC}"
exit 1
}
echo "${GREEN}✅ SpecLinter initialized successfully!${NC}"
fi
echo ""
echo "${CYAN}🎯 Next Steps:${NC}"
echo "1. Start the MCP server: ${BLUE}docker run -it --rm -v \$(pwd):/workspace speclinter/mcp:latest serve${NC}"
echo "2. Add MCP configuration to your AI IDE (see 'help' command)"
echo "3. Try: ${BLUE}\"Initialize SpecLinter in my project\"${NC} in your AI IDE"
}
# Validate existing features
validate_features() {
echo "${GREEN}🔍 Validating SpecLinter features...${NC}"
if [ ! -d "/workspace/.speclinter" ]; then
echo "${RED}❌ No SpecLinter project found${NC}"
echo "${YELLOW}💡 Run 'init' first or mount a directory with SpecLinter initialized${NC}"
exit 1
fi
# Check for features
if [ ! -d "/workspace/speclinter-tasks" ] || [ -z "$(ls -A /workspace/speclinter-tasks 2>/dev/null)" ]; then
echo "${YELLOW}⚠️ No features found to validate${NC}"
echo "${BLUE}💡 Create some specifications first using the MCP tools${NC}"
exit 0
fi
echo "${BLUE}📊 Found features to validate...${NC}"
# List features and their status
for feature_dir in /workspace/speclinter-tasks/*/; do
if [ -d "$feature_dir" ]; then
feature_name=$(basename "$feature_dir")
echo "${CYAN}📋 Feature: ${feature_name}${NC}"
node /app/dist/cli.js status "$feature_name" 2>/dev/null || echo "${YELLOW} Status unavailable${NC}"
echo ""
fi
done
echo "${GREEN}✅ Validation complete${NC}"
echo "${YELLOW}💡 For detailed AI-powered validation, use the MCP tools in your AI IDE${NC}"
}
# Show status of all features
show_status() {
echo "${GREEN}📊 SpecLinter Project Status${NC}"
echo ""
if [ ! -d "/workspace/.speclinter" ]; then
echo "${RED}❌ No SpecLinter project found${NC}"
echo "${YELLOW}💡 Run 'init' first${NC}"
exit 1
fi
if [ ! -d "/workspace/speclinter-tasks" ] || [ -z "$(ls -A /workspace/speclinter-tasks 2>/dev/null)" ]; then
echo "${YELLOW}📝 No features found${NC}"
echo "${BLUE}💡 Create specifications using the MCP tools in your AI IDE${NC}"
exit 0
fi
echo "${BLUE}📋 Features:${NC}"
for feature_dir in /workspace/speclinter-tasks/*/; do
if [ -d "$feature_dir" ]; then
feature_name=$(basename "$feature_dir")
echo ""
node /app/dist/cli.js status "$feature_name" 2>/dev/null || echo "${YELLOW} ${feature_name}: Status unavailable${NC}"
fi
done
}
# Start MCP server
start_server() {
echo "${GREEN}🚀 Starting SpecLinter MCP Server...${NC}"
echo "${BLUE}📡 Server will communicate via stdio (MCP protocol)${NC}"
echo "${YELLOW}💡 Connect this to your AI IDE using MCP configuration${NC}"
echo ""
# Ensure workspace is initialized
if [ ! -d "/workspace/.speclinter" ]; then
echo "${CYAN}🔧 Auto-initializing SpecLinter...${NC}"
init_speclinter
echo ""
fi
# Start the server
exec node /app/dist/cli.js serve
}
# Main entrypoint logic
main() {
# Handle different commands
case "${1:-serve}" in
"serve")
start_server
;;
"init")
print_logo
init_speclinter
;;
"validate")
print_logo
validate_features
;;
"status")
print_logo
show_status
;;
"help"|"--help"|"-h")
print_logo
print_usage
;;
*)
print_logo
echo "${RED}❌ Unknown command: $1${NC}"
echo ""
print_usage
exit 1
;;
esac
}
# Run main function with all arguments
main "$@"
