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"