mcp-dev-env-setup: Instructions file for Codex

AI Agent Integration Guide

This document provides guidance for AI agents (like Claude, ChatGPT, etc.) that want to use or contribute to this MCP server.

Project Overview

mcp-dev-env-setup is a Model Context Protocol (MCP) server that automates the setup of development environments across macOS and Linux systems. It provides intelligent package manager detection and cross-platform tool installation capabilities.

Architecture

Core Principles

1. Modular Design: The codebase is organized into distinct modules with clear responsibilities
2. Platform Agnostic: Automatically detects OS and package manager to provide appropriate installation methods
3. Extensible: Easy to add new tools and package managers
4. Testable: Comprehensive unit tests for all core functionality

Module Structure

src/
├── core/                      # Core business logic
│   ├── package-manager.ts     # OS and package manager detection
│   └── tool-config.ts         # Tool definitions and configurations
├── installers/                # Installation modules
│   └── unified-installer.ts   # Unified installation logic
├── validators/                # Validation modules
│   └── environment-validator.ts # Environment checking and validation
├── utils/                     # Utility functions
│   ├── shell.ts              # Shell command execution
│   └── check.ts              # Environment checking utilities
├── tools/                     # Legacy tool implementations
│   └── install.ts            # Original installation functions
└── __tests__/                # Unit tests
    ├── package-manager.test.ts
    ├── tool-config.test.ts
    └── shell.test.ts

Key Modules

1. Package Manager Detection (core/package-manager.ts)

Purpose: Automatically detect the operating system and available package manager.

Key Functions:

• detectOS(): Identifies the current operating system
• detectPackageManager(): Finds the available package manager
• getSystemInfo(): Returns comprehensive system information
• installPackage(): Installs a package using the detected package manager