MCP Fixer

🚀 🔧 MCP Fixer Server

这是一款针对Claude Desktop中Model Context Protocol (MCP) 服务器的综合诊断与修复工具。它能够自动检测、诊断并修复常见的MCP配置问题，为MCP服务器的稳定运行提供有力保障。

✨ 主要特性

• 🔍 配置分析 - 验证JSON语法、路径和服务器设置。
• 📊 服务器状态监控 - 对单个MCP服务器进行实时健康检查。
• ⚙️ 依赖验证 - 确保Node.js、npm、Python、UV正确安装。
• 🌐 端口冲突检测 - 识别常见MCP端口上的网络冲突。
• 🔧 自动语法修复 - 修复JSON错误并自动创建备份。
• 📝 日志文件分析 - 解析MCP日志以查找错误模式和深入信息。
• 💡 智能建议 - 提供有针对性的修复建议。
• 🛡️ 安全优先 - 在进行任何修改之前创建备份。

🚀 快速开始

前提条件

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

安装

选项1：NPX（推荐）

npx @your-username/mcp-fixer-server install

选项2：全局安装

npm install -g @your-username/mcp-fixer-server
mcp-fixer install

选项3：克隆并安装

git clone https://github.com/your-username/mcp-fixer-server.git
cd mcp-fixer-server
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"

📋 可用工具

🎯 常见检测问题

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

🔧 CLI使用方法

# 安装到Claude Desktop
mcp-fixer install

# 检查安装状态
mcp-fixer check

# 从Claude Desktop移除
mcp-fixer uninstall

# 显示当前配置
mcp-fixer config

# 直接运行服务器（开发环境）
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/your-username/mcp-fixer-server.git
cd mcp-fixer-server
npm install
npm test

📚 详细文档

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

🔄 更新日志

查看CHANGELOG.md了解版本历史和更新内容。

📄 许可证

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

🙏 致谢

• Anthropic 提供Claude Desktop和MCP。
• Model Context Protocol 社区。
• 所有提供反馈的贡献者和用户。

📞 支持

• 📖 文档
• 🐛 报告问题
• 💬 讨论
• 📧 邮箱：support@yourproject.com

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