🔧 MCP Fixer Server
About
Build-and-run diagnostics for Claude Desktop MCP servers in one command. MCP-Fixer runs 25 diagnostics on every MCP server, pinpoints port/path issues, and offers one-click fixes – no config.
Details
- License
- MIT license
Explore
- 🔍 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🔧 MCP Fixer ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Node.js 18+ installed
- Claude Desktop with MCP support
- npm or npx available
npm install -g @your-username/mcp-fixer-server
mcp-fixer install
git clone https://github.com/your-username/mcp-fixer-server.git
cd mcp-fixer-server
npm install
npm run install:claude
mcp-fixer install
mcp-fixer check
mcp-fixer config
git clone https://github.com/your-username/mcp-fixer-server.git
cd mcp-fixer-server
npm install
npm test
```
diagnose_mcp_config
Comprehensive configuration analysis
check_mcp_server_status
Individual server health checks
fix_config_syntax
Automatic JSON syntax repair
validate_dependencies
System dependency verification
check_port_conflicts
Port availability scanning
generate_diagnostic_report
Complete system analysis
suggest_fixes
Targeted solution recommendations
| Tool | Description | Use Case |
|------|-------------|----------|
| diagnose_mcp_config | Comprehensive configuration analysis | First-line diagnosis |
| check_mcp_server_status | Individual server health checks | Server connectivity issues |
| fix_config_syntax | Automatic JSON syntax repair | Configuration errors |
| validate_dependencies | System dependency verification | Missing tools/packages |
| check_port_conflicts | Port availability scanning | Network conflicts |
| generate_diagnostic_report | Complete system analysis | Full health assessment |
| suggest_fixes | Targeted solution recommendations | Issue resolution |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83d\udd27 mcp fixer server": {
"mcp-fixer": {
"command": "npx",
"args": [
"@kajdep/mcp-fixer",
"serve"
],
"type": "stdio"
}
}
}
}McpServers
{
"mcp-fixer": {
"command": "npx",
"args": [
"@kajdep/mcp-fixer",
"serve"
],
"type": "stdio"
}
}
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 @your-username/mcp-fixer-server install
Option 2: Global Install
npm install -g @your-username/mcp-fixer-server
mcp-fixer install
Option 3: Clone and Install
git clone https://github.com/your-username/mcp-fixer-server.git
cd mcp-fixer-server
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
| Tool | Description | Use Case |
|------|-------------|----------|
| diagnose_mcp_config | Comprehensive configuration analysis | First-line diagnosis |
| check_mcp_server_status | Individual server health checks | Server connectivity issues |
| fix_config_syntax | Automatic JSON syntax repair | Configuration errors |
| validate_dependencies | System dependency verification | Missing tools/packages |
| check_port_conflicts | Port availability scanning | Network conflicts |
| generate_diagnostic_report | Complete system analysis | Full health assessment |
| suggest_fixes | Targeted solution recommendations | Issue 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
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
