🔧 MCP修复服务器
](https://smithery.ai/server/@Kajdep/mcp-fixer)
 ](https://nodejs.org/) 
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许可证获得许可-请参阅 许可证 文件以获取详细信息。
🙏 致谢
- Anthropic 克劳德桌面和MCP
📞 支持
______________________________________________________________________
由以下材料制成❤️ 对于MCP社区“#mcp修复程序”