# mcp-config-tools

MCP server providing configuration file tools for AI agents. Parse, validate, merge, convert, and diff configuration files across all common formats.

## Tools

### json_config

Read, validate, deep merge, and diff JSON/JSONC configuration files.

- **parse** — Parse JSONC (JSON with comments and trailing commas)
- **validate** — Check if content is valid JSON/JSONC
- **merge** — Deep merge two JSON configs (overlay wins on conflicts)
- **diff** — Find structural differences between two JSON configs

### yaml_config

Read, validate, and convert YAML configuration files.

- **parse** — Parse YAML content to structured data
- **validate** — Check if content is valid YAML
- **to_json** — Convert YAML to JSON
- **from_json** — Convert JSON to YAML
- **validate_schema** — Validate against docker-compose, GitHub Actions, or Kubernetes schemas

### toml_parser

Parse TOML configuration files (Cargo.toml, pyproject.toml, etc.).

- **parse** — Parse TOML content to structured data
- **extract_section** — Extract a specific section by dot-path
- **list_deps** — List dependencies from Cargo.toml or pyproject.toml
- **compare_versions** — Compare two semantic version strings

### ini_parser

Parse INI and properties configuration files.

- **parse** — Parse INI content into sections and key-value pairs
- **get_sections** — List all section names
- **get_value** — Get a specific key from a section
- **to_json** — Convert INI to JSON
- **from_json** — Convert JSON back to INI format

### config_diff

Compare two configuration files in any supported format.

- Auto-detects file format (JSON, YAML, TOML, INI)
- Cross-format comparison (e.g., compare a YAML file against a JSON file)
- Shows additions, removals, and changes with full nested paths

## Setup

```bash
npm install
npm run build
```

## MCP Configuration

```json
{
  "mcpServers": {
    "config-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-config-tools/dist/index.js"]
    }
  }
}
```

## Dependencies

- `@modelcontextprotocol/sdk` — MCP protocol SDK
- `yaml` — YAML parser and serializer
- Built-in TOML and INI parsers (zero extra dependencies)