mcpField
🔧
🔧 MCP Fixer Server

🔧 MCP Fixer Server

Local
github.com/KajdepDeveloper Tools3Updated 66w ago
Repository

About 🔧 MCP Fixer Server

MCP Fixer Server diagnoses and repairs common MCP configuration issues in Claude Desktop. It checks configuration, server health, dependencies, ports, and logs, and can fix JSON syntax errors with backups.

Key features

  1. 01Validate configuration syntax and paths
  2. 02Check MCP server health
  3. 03Verify system dependencies
  4. 04Detect port conflicts
  5. 05Repair JSON syntax with backups
  6. 06Analyze logs and suggest fixes

Use cases

  1. 01Investigate servers that fail to start
  2. 02Find configuration and path errors
  3. 03Check missing dependencies or port conflicts
  4. 04Generate a diagnostic report for MCP setup

MCP support

It exposes diagnostic and repair tools to MCP clients, including configuration analysis, server status checks, dependency validation, and JSON syntax repair.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "fixer": {
      "command": "npx",
      "args": [
        "-y",
        "@kajdep/mcp-fixer"
      ]
    }
  }
}
Run commandnpx -y @kajdep/mcp-fixer

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@kajdep/mcp-fixer

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

🔧 MCP Fixer Server

smithery badge

License: MIT Node.js Version MCP Compatible

A comprehensive diagnostic and repair tool for Model Context Protocol (MCP) servers in Claude Desktop. Automatically detects, diagnoses, and fixes common MCP configuration issues.

🌟 Features

  • 🔍 Configuration Analysis - Validates JSON syntax, paths, and server settings
  • 📊 Server Status Monitoring - Real-time health checks for individual MCP servers
  • ⚙️ Dependency Validation - Ensures Node.js, npm, Python, UV are properly installed
  • 🌐 Port Conflict Detection - Identifies network conflicts on common MCP ports
  • 🔧 Automatic Syntax Fixing - Repairs JSON errors with automatic backup creation
  • 📝 Log File Analysis - Parses MCP logs for error patterns and insights
  • 💡 Smart Suggestions - Provides targeted fix recommendations
  • 🛡️ Safety First - Creates backups before any modifications

🚀 Quick Start

Prerequisites
  • Node.js 18+ installed
  • Claude Desktop with MCP support
  • npm or npx available
Installation
Option 1: NPX (Recommended)
npx @kajdep/mcp-fixer install
Option 2: Global Install
npm install -g @kajdep/mcp-fixer
mcp-fixer install
Option 3: Clone and Install
git clone https://github.com/kajdep/mcp-fixer.git
cd mcp-fixer
npm install
npm run install:claude
Usage

Once installed, simply ask Claude to use the diagnostic tools:

"Claude, can you diagnose my MCP configuration?"
"Claude, check the status of my MCP servers"
"Claude, generate a comprehensive diagnostic report"
"Claude, suggest fixes for my MCP issues"

📋 Available Tools

ToolDescriptionUse Case
diagnose_mcp_configComprehensive configuration analysisFirst-line diagnosis
check_mcp_server_statusIndividual server health checksServer connectivity issues
fix_config_syntaxAutomatic JSON syntax repairConfiguration errors
validate_dependenciesSystem dependency verificationMissing tools/packages
check_port_conflictsPort availability scanningNetwork conflicts
generate_diagnostic_reportComplete system analysisFull health assessment
suggest_fixesTargeted solution recommendationsIssue resolution

🎯 Common Issues Detected

  • JSON Syntax Errors - Missing commas, brackets, quotes
  • Path Issues - Incorrect Windows path escaping
  • Missing Dependencies - Node.js, npm, Python not found
  • Port Conflicts - Multiple services using same ports
  • Server Crashes - MCP servers failing to start
  • Environment Variables - Missing or empty API keys
  • Permission Errors - File access and executable permissions

🔧 CLI Usage

# Install to Claude Desktop
mcp-fixer install

# Check installation status
mcp-fixer check

# Remove from Claude Desktop
mcp-fixer uninstall

# Show current configuration
mcp-fixer config

# Run server directly (development)
mcp-fixer run

📊 Example Output

{
  "configPath": "/path/to/claude_desktop_config.json",
  "exists": true,
  "valid": true,
  "issues": [],
  "warnings": [
    {
      "type": "path_escaping",
      "severity": "medium", 
      "server": "filesystem",
      "message": "Potential path escaping issue...",
      "fix": "Ensure Windows paths use double backslashes"
    }
  ],
  "serverCount": 15,
  "recommendations": [
    "Consider disabling unused servers to improve startup time"
  ]
}

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Quick Contribution Setup
git clone https://github.com/kajdep/mcp-fixer.git
cd mcp-fixer
npm install
npm test

📝 Documentation

🔄 Changelog

See CHANGELOG.md for version history and updates.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

📞 Support

Made with ❤️ for the MCP community"# mcp-fixer"

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.