# ⚙️ Node Config (`@stellarwp/mcp-node-config`)

A lightweight configuration management library for CLI MCP servers with WordPress integration support.

## 📦 What is this?

This package provides a simple, type-safe way to manage environment-based configuration for MCP servers, with built-in WordPress-specific configuration validation and error handling.

## ✨ Features

- **🛡️ Type Safety**: Full TypeScript support with strict typing
- **⚡ Environment Variables**: Automatic environment variable loading with dotenvx
- **✅ Validation**: Built-in configuration validation and missing config detection
- **🚫 Silent Operation**: Designed to work silently in MCP server environments

## 🚀 Getting Started

### Prerequisites
- Node.js 18+ or Bun 1.2.20+
- Environment variables for WordPress configuration

### Installation

```bash
# Install the package
bun add @stellarwp/mcp-node-config

# Or with npm
npm install @stellarwp/mcp-node-config
```

### Environment Setup

Copy the [.env.example](.env.example) file in your project root and fill out the correct values for your environment:

```bash
WP_REST_URL=https://your-site.com/wp-json/wp/v2/
WP_USERNAME=your_username
WP_APP_PASSWORD=your_application_password

# Uncomment to disable SSL certificate verification for local server development. Should not be enabled on production!
# NODE_TLS_REJECT_UNAUTHORIZED=0
```

> **💡 Local Development Tip**: When developing on a local environment where SSL certificates wouldn't validate (e.g., localhost with self-signed certs), you can set `NODE_TLS_REJECT_UNAUTHORIZED=0` in your environment variables. This is particularly important when using the [API Fetch package](../api-fetch/README.md) to connect to local WordPress installations. **Note**: This should only be used in development environments, never in production.

## 🔧 Usage

### Basic Configuration

```typescript
#!/usr/bin/env node

// Import env first to load environment variables
import '@stellarwp/mcp-node-config/env';

import { config } from '@stellarwp/mcp-node-config';

// Check if configuration is valid
if (!config.isValid()) {
    const missing = config.getMissingConfig();
    throw new Error(`Missing required env vars: ${missing.join(', ')}`);
}

// Access configuration values
console.log('WordPress REST URL:', config.wpRestUrl);
console.log('Username:', config.wpUsername);
```


## 📚 API Reference

### Configuration Object

The `config` object provides the following properties and methods:

#### Properties
- `wpRestUrl: string` - WordPress REST API base URL
- `wpUsername: string` - WordPress username for authentication
- `wpAppPassword: string` - WordPress application password

#### Methods
- `getMissingConfig(): string[]` - Returns array of missing environment variable names
- `isValid(): boolean` - Returns true if all required configuration is present

### Environment Variables

| Variable | Description | Required |
|----------|-------------|----------|
| `WP_REST_URL` | WordPress REST API base URL | Yes |
| `WP_USERNAME` | WordPress username | Yes |
| `WP_APP_PASSWORD` | WordPress application password | Yes |
| `NODE_TLS_REJECT_UNAUTHORIZED` | Set to `0` for local development with invalid SSL certs | No |