graph TB
    subgraph "AI Clients"
        K[Kiro IDE]
        CD[Claude Desktop]
        CU[Cursor]
    end

    subgraph "MCP Transport Layer"
        STDIO[stdio / JSON-RPC 2.0]
    end

    subgraph "MCP Server Suite"
        subgraph "aws-explorer"
            S3[list-s3-buckets<br/>list-s3-objects]
            EC2[list-ec2-instances<br/>describe-ec2-instance]
            LAMBDA[list-lambda-functions<br/>describe-lambda-function]
            DYNAMO[list-dynamodb-tables<br/>describe-dynamodb-table]
        end

        subgraph "database"
            QUERY[query]
            INSERT[insert]
            UPDATE[update]
            DELETE[delete]
            SCHEMA[list-tables / describe-table<br/>create-table]
        end

        subgraph "web-scraper"
            FETCH[fetch-page]
            LINKS[extract-links]
            TEXT[extract-text]
            SEARCH[search-in-page]
        end

        subgraph "shared"
            LOGGER[Logger]
            ERRORS[Error Handling]
            TYPES[Response Types]
            MW[Middleware<br/>Retry / Circuit Breaker]
        end
    end

    subgraph "External Services"
        AWS[AWS SDK v3]
        SQLITE[SQLite via sql.js]
        WEB[Web / HTTP]
    end

    K & CD & CU --> STDIO
    STDIO --> S3 & EC2 & LAMBDA & DYNAMO
    STDIO --> QUERY & INSERT & UPDATE & DELETE & SCHEMA
    STDIO --> FETCH & LINKS & TEXT & SEARCH

    S3 & EC2 & LAMBDA & DYNAMO --> AWS
    QUERY & INSERT & UPDATE & DELETE & SCHEMA --> SQLITE
    FETCH & LINKS & TEXT & SEARCH --> WEB

    aws-explorer & database & web-scraper -.-> shared

graph LR
    ROOT[mcp-server-suite<br/>Turborepo Monorepo]
    ROOT --> SHARED["@mcp-suite/shared<br/>Logger, Errors, Types, Middleware"]
    ROOT --> AWS["@mcp-suite/aws-explorer<br/>8 tools, 2 resources"]
    ROOT --> DB["@mcp-suite/database<br/>7 tools, 3 resources"]
    ROOT --> WS["@mcp-suite/web-scraper<br/>4 tools, 1 resource"]

    AWS --> SHARED
    DB --> SHARED
    WS --> SHARED

git clone <repository-url>
cd mcp-server-suite
npm install
npm run build

npm run test          # Run all tests (184 tests across 4 packages)
npm run test:coverage # Run with coverage reports

{
  "mcpServers": {
    "aws-explorer": {
      "command": "node",
      "args": ["./packages/aws-explorer/dist/index.js"]
    },
    "database": {
      "command": "node",
      "args": ["./packages/database/dist/index.js"],
      "env": {
        "MCP_DB_PATH": "./data/my-database.db"
      }
    },
    "web-scraper": {
      "command": "node",
      "args": ["./packages/web-scraper/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "aws-explorer": {
      "command": "node",
      "args": ["/absolute/path/to/packages/aws-explorer/dist/index.js"]
    },
    "database": {
      "command": "node",
      "args": ["/absolute/path/to/packages/database/dist/index.js"]
    },
    "web-scraper": {
      "command": "node",
      "args": ["/absolute/path/to/packages/web-scraper/dist/index.js"]
    }
  }
}

classDiagram
    class IDatabaseRepository {
        <<interface>>
        +listTables(includeRowCounts?) TableListResult
        +describeTable(tableName) TableSchema
        +createTable(tableName, columns, ifNotExists?) WriteResult
        +query(sql, params?, limit?) QueryResult
        +insert(table, data) BatchInsertResult
        +update(table, set, where, params?) WriteResult
        +delete(table, where, params?) WriteResult
    }

    class DatabaseRepository {
        -isReadOnlyQuery(sql) boolean
        -validateTableExists(table) void
        -validateWhereClause(where, operation) void
    }

    class queryTool
    class insertTool
    class updateTool
    class deleteTool

    IDatabaseRepository <|.. DatabaseRepository
    queryTool --> DatabaseRepository
    insertTool --> DatabaseRepository
    updateTool --> DatabaseRepository
    deleteTool --> DatabaseRepository

stateDiagram-v2
    [*] --> CLOSED
    CLOSED --> OPEN : failure threshold reached
    OPEN --> HALF_OPEN : recovery time elapsed
    HALF_OPEN --> CLOSED : success
    HALF_OPEN --> OPEN : failure
    CLOSED --> CLOSED : success / below threshold

flowchart TD
    A[Tool Called] --> B{Execute}
    B -->|Success| C[createJsonResponse]
    B -->|Error| D{Error Type?}
    D -->|ValidationError| E[createErrorResponse<br/>400]
    D -->|NotFoundError| F[createErrorResponse<br/>404]
    D -->|RateLimitError| G[Retry with backoff]
    D -->|ExternalServiceError| H[Circuit Breaker check]
    D -->|Unknown Error| I[formatErrorResponse<br/>500]
    G -->|Max retries| I
    H -->|Circuit OPEN| J[Service unavailable]
    H -->|Circuit CLOSED| B

# Build all packages
npm run build

# Type check without emitting
npm run typecheck

# Run tests
npm run test

# Clean build artifacts
npm run clean