项目介绍
🔧 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-ffier
npm install
npm run install:claude
使用方法
安装后，只需让Claude使用诊断工具：
"Claude，你能诊断我的MCP配置吗？"
"Claude，检查我的MCP服务器状态"
"Claude，生成一份全面的诊断报告"
"Claude，为我的MCP问题提供建议"
📋 可用工具
| 工具 | 描述 | 使用场景 |
|---|---|---|
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": "潜在的路径转义问题...",
"fix": "确保Windows路径使用双反斜杠"
}
],
"serverCount": 15,
"recommendations": [
"考虑禁用未使用的服务器以提高启动时间"
]
}
🤝 贡献
我们欢迎贡献！请参阅我们的贡献指南了解详情。
快速贡献设置
git clone https://github.com/kajdep/mcp-fixer.git
cd mcp-fixer
npm install
npm test
📝 文档
🔄 更新日志
查看CHANGELOG.md了解版本历史和更新。
📄 许可证
本项目采用MIT许可证 - 查看LICENSE文件了解详细信息。
🙏 致谢
- Anthropic为Claude Desktop和MCP
📞 支持
为MCP社区制作 ❤️