r3habb99/mcp-server-agent

# Install dependencies and build
npm install && npm run build

# Run basic tests to verify functionality
npm test

# Start the server
npm start

npm install

npm run build

# Start the server
npm start

# Or run directly
node build/server/index.js

# Run with hot reload
npm run dev

# Show help
augment-mcp-server --help

# Show version
augment-mcp-server --version

# Show current configuration
augment-mcp-server --config

# Logging
LOG_LEVEL=info                    # error, warn, info, debug
LOG_FILE=/path/to/logfile        # Optional log file path

# Security
MAX_FILE_SIZE=104857600          # Maximum file size (100MB)
MAX_BATCH_SIZE=100               # Maximum batch operation size
COMMAND_TIMEOUT=30000            # Command timeout in milliseconds
ALLOWED_DIRECTORIES=.,./src      # Comma-separated allowed directories
BLOCKED_DIRECTORIES=/etc,/usr    # Comma-separated blocked directories

# Performance
CACHE_ENABLED=true               # Enable caching
CACHE_TTL=300000                 # Cache TTL in milliseconds
MAX_CONCURRENT_FILE_OPS=10       # Max concurrent file operations
MAX_CONCURRENT_SEARCHES=5        # Max concurrent searches

AUGMENT_ENABLED=true                           # Enable Augment AI features
AUGMENT_API_ENDPOINT=http://localhost:8080     # Augment AI API endpoint
AUGMENT_API_KEY=your-api-key                   # API key (if required)
AUGMENT_MODEL=claude-3-sonnet                  # AI model to use
AUGMENT_MAX_TOKENS=4096                        # Maximum tokens per request
AUGMENT_TEMPERATURE=0.7                        # AI temperature setting

# Core Features
FEATURE_FILE_OPERATIONS=true        # Enable file operations
FEATURE_SYSTEM_INFO=true            # Enable system information tools
FEATURE_PROCESS_MANAGEMENT=true     # Enable process management
FEATURE_NETWORK_INFO=true           # Enable network information
FEATURE_CODE_ANALYSIS=true          # Enable code analysis tools
FEATURE_SEARCH_OPERATIONS=true      # Enable search operations

# Resources
FEATURE_FILE_RESOURCES=true         # Enable file resources
FEATURE_SYSTEM_RESOURCES=true       # Enable system resources
FEATURE_LOG_RESOURCES=true          # Enable log resources

# Prompts
FEATURE_CODE_REVIEW_PROMPTS=true    # Enable code review prompts
FEATURE_DOCUMENTATION_PROMPTS=true  # Enable documentation prompts
FEATURE_DEBUGGING_PROMPTS=true      # Enable debugging prompts

# Experimental
EXPERIMENTAL_AI_INTEGRATION=false   # Enable experimental AI features
EXPERIMENTAL_ADVANCED_ANALYTICS=false
EXPERIMENTAL_REAL_TIME_MONITORING=false

{
  "mcpServers": {
    "augment-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/augment-mcp-server/build/server/index.js"],
      "env": {
        "LOG_LEVEL": "info",
        "AUGMENT_ENABLED": "true"
      }
    }
  }
}

{
  "mcpServers": {
    "augment-mcp-server": {
      "command": "node",
      "args": ["C:\\absolute\\path\\to\\augment-mcp-server\\build\\server\\index.js"],
      "env": {
        "LOG_LEVEL": "info",
        "AUGMENT_ENABLED": "true"
      }
    }
  }
}

src/
├── 🖥️  server/                    # Server implementation layer
│   ├── index.ts                  # Main server entry point with graceful shutdown
│   ├── config.ts                 # Environment-based configuration management
│   └── handlers/                 # MCP protocol handlers
│       ├── tools.ts              # Tool implementations with validation
│       ├── resources.ts          # Resource providers with caching
│       └── prompts.ts            # AI-powered prompt templates
├── 🔧 services/                  # Business logic layer
│   ├── fileService.ts            # File system operations with security
│   ├── systemService.ts          # System information and monitoring
│   └── augmentService.ts         # Augment AI integration service
├── 🎯 interfaces/                # Organized TypeScript interfaces
│   ├── server/                   # Server configuration interfaces
│   ├── file/                     # File operation interfaces
│   ├── system/                   # System information interfaces
│   ├── mcp/                      # MCP protocol interfaces
│   ├── analysis/                 # Code analysis interfaces
│   ├── git/                      # Git integration interfaces
│   └── index.ts                  # Central interface export hub
└── 🛠️  utils/                    # Utility functions
    ├── logger.ts                 # Structured logging with Winston
    └── validation.ts             # Zod-based input validation schemas

// Single import point for all interfaces
import type {
  ServerConfig, AugmentConfig,           // Server configuration
  FileInfo, SearchOptions, SearchResult, // File operations
  SystemInfo, ProcessInfo, HealthCheck,  // System information
  ToolResult, ResourceContent,           // MCP protocol
  CodeAnalysisResult                     // Code analysis
} from '../interfaces/index.js';

# Development workflow
npm install              # Install dependencies
npm run build           # Build the project
npm test               # Verify everything works
npm start              # Start the server

# Run all tests
npm test

# Run tests with coverage
npm run test -- --coverage

# Run specific test file
npm test -- fileService.test.ts

# Run tests in watch mode
npm run test:watch

LOG_LEVEL=debug npm start

tail -f logs/combined.log
tail -f logs/error.log