🔧 MCP Fixer Server

🔧 MCP 修复器服务

Claude Desktop 中 Model Context Protocol（MCP）服务的综合诊断与修复工具。自动检测、诊断并修复常见的 MCP 配置问题。

🌟 功能

• 🔍 配置分析 - 验证 JSON 语法、路径和服务设置
• 📊 服务状态监控 - 实时检查各个 MCP 服务的运行状况
• ⚙️ 依赖项验证 - 确保 Node.js、npm、Python、UV 已正确安装
• 🌐 端口冲突检测 - 识别常用 MCP 端口上的网络冲突
• 🔧 自动语法修复 - 修复 JSON 错误并自动创建备份
• 📝 日志文件分析 - 解析 MCP 日志，查找错误模式并提供见解
• 💡 智能建议 - 提供有针对性的修复建议
• 🛡️ 安全第一 - 修改前创建备份

🚀 快速开始

先决条件

• 已安装 Node.js 18+
• 支持 MCP 的 Claude Desktop
• 可使用 npm 或 npx

安装

选项 1：NPX（推荐）

npx @kajdep/mcp-fixer install

选项 2：全局安装

npm install -g @kajdep/mcp-fixer
mcp-fixer install

选项 3：克隆并安装

git clone https://github.com/kajdep/mcp-fixer.git
cd mcp-fixer
npm install
npm run install:claude

使用方法

安装完成后，只需让 Claude 使用诊断工具：

"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"

📋 可用工具

工具	描述	使用场景
diagnose_mcp_config	全面分析配置	初步诊断
check_mcp_server_status	检查单个服务的运行状况	服务连接问题
fix_config_syntax	自动修复 JSON 语法	配置错误
validate_dependencies	验证系统依赖项	缺少工具/软件包
check_port_conflicts	扫描端口可用性	网络冲突
generate_diagnostic_report	全面分析系统	完整运行状况评估
suggest_fixes	提供有针对性的解决方案建议	问题解决

🎯 检测到的常见问题

• JSON 语法错误 - 缺少逗号、括号或引号
• 路径问题 - Windows 路径转义不正确
• 缺少依赖项 - 找不到 Node.js、npm、Python
• 端口冲突 - 多个服务使用同一端口
• 服务崩溃 - MCP 服务无法启动
• 环境变量 - API 密钥缺失或为空
• 权限错误 - 文件访问和可执行权限

🔧 CLI 用法

# 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

📊 输出示例

{
  "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"
  ]
}

🤝 参与贡献

欢迎参与贡献！详情请参阅贡献指南。

快速设置贡献环境

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

📝 文档

• 安装指南
• 使用示例
• 故障排除
• API 文档
• 贡献指南

🔄 更新日志

版本历史和更新内容请参阅 CHANGELOG.md。

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🙏 致谢

• Anthropic 提供 Claude Desktop 和 MCP

📞 支持

• 📖 文档
• 🐛 报告问题
• 💬 讨论

---

为 MCP 社区倾心打造 ❤️"# mcp-fixer"