skills.rest
photonics-dhl
photonics-dhlCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

claude-code-settings-mcp

Normalize Claude Code MCP settings in ~/.claude.json and convert Windows paths to Linux.

Updated Apr 30, 2026
Search Tags:#mcp#json#settings#claude-code#configure#path-normalization
One-click install
npx skills add https://github.com/photonics-dhl/Hermes --skill claude-code-settings-mcp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-code-settings-mcp
Source: https://github.com/photonics-dhl/Hermes/tree/main/hermes-home/skills/dev-helper/claude-code-settings-mcp
Command: npx skills add https://github.com/photonics-dhl/Hermes --skill claude-code-settings-mcp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code MCP server configurations often suffer from JSON syntax errors, missing or misplaced path mappings, and unclear location of MCP settings. This Skill provides a safe, repeatable approach to fix and manage Claude Code MCP servers.

Core Features & Use Cases

  • Normalize the MCP config file at ~/.claude.json and ensure it contains a valid mcpServers block.
  • Remove JSON-isms like comments that parsers can't handle and convert Windows paths to Linux equivalents.
  • Update or add MCP servers using claude mcp add or by editing the JSON file directly to ensure correct endpoints are defined.

Quick Start

Use claude mcp add to register a new MCP server or edit ~/.claude.json to update the mcpServers block.

Frequently Asked Questions about claude-code-settings-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Claude Code MCP server configuration errors in ~/.claude.json?▼

Fix Claude Code MCP server configuration by normalizing the mcpServers block in ~/.claude.json. This removes unsupported JSON constructs like comments and converts Windows paths to Linux equivalents, ensuring valid server definitions.

What is the best way to normalize Windows paths to Linux equivalents in claude mcp settings?▼

Normalizing Windows paths to Linux equivalents in claude mcp settings is handled safely by converting the path strings within the ~/.claude.json configuration file. This ensures MCP servers are correctly defined across different operating systems.

How do I add a new MCP server using claude mcp add?▼

Add a new MCP server using the `claude mcp add` command to safely register the endpoint. Alternatively, you can directly edit the mcpServers JSON block in ~/.claude.json to ensure correct server definitions are applied idempotently.

Why does my MCP configuration break when I add JSON comments?▼

MCP configuration breaks because standard JSON parsers cannot handle comments. This configuration normalization process removes unsupported JSON-isms like comments to ensure the mcpServers block remains valid and parseable.

Can I safely edit the mcpServers JSON block directly without breaking existing endpoints?▼

Yes, you can safely edit the mcpServers JSON block directly. The normalization process applies safe, idempotent updates to ensure existing MCP server endpoints remain intact and correctly defined in ~/.claude.json.

Does Claude Code support MCP server configurations with Windows path formats?▼

Claude Code MCP configurations require Linux path equivalents. The normalization process specifically converts Windows paths to Linux formats within ~/.claude.json to ensure the MCP servers function correctly in the target environment.

Related Skills

Explore More Software Engineering Skills→
ROYCE-8425ROYCE-8425
1

laravel-plugin-discovery

Discover and assess Laravel packages via LaraPlugins.io MCP.

Community
Intermediate
furkankoykiranfurkankoykiran
4

add-mcp

Parse JSON mcpServers configs and generate claude mcp add commands.

Community
Intermediate
WayneWalterBerryWayneWalterBerry

windows-compatibility

Standardize cross-platform path handling for scripts and tooling.

Community
Intermediate
apacheapache
79

magpie-setup-isolated-setup-verify

Verify Magpie framework secure setup by checking configurations and tool versions.

Official
Advanced