AI导哈

MCP修复工具

用于Claude Desktop中Model Context Protocol (MCP)服务器的综合诊断和修复工具，可自动检测、诊断和修复常见的MCP配置问题。

  • by Kajdep
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 kajdep/mcp-fixer

使用说明

🔧 MCP修复服务器

Claude Desktop中模型上下文协议（MCP）服务器的综合诊断和修复工具。自动检测、诊断和修复常见的MCP配置问题。

🌟 特性

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

🚀 快速开始

先决条件

  • 已安装Node.js 18+
  • 支持MCP的Claude桌面
  • 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

📝 文档

🔄 更新日志

看 更改日志.md 查看版本历史和更新。

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

📞 支持

由以下材料制成❤️ 对于MCP社区“#mcp修复程序”

相关 MCP