金大哥 - mcp-fixer MCP 详情

article

README

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

📋 可用工具

| 工具 | 描述 | 使用场景 | |------|-------------|----------| | 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使用方法

# 安装到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

📚 详细文档

🔄 更新日志

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

📄 许可证

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

🙏 致谢

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

📞 支持

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

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

mcp-fixer