🔧 MCP Fixer Server

🔧 MCP Fixer Server

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-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

📝 ドキュメント

• インストールガイド
• 使用例
• トラブルシューティング
• API ドキュメント
• コントリビューションガイド

🔄 変更履歴

バージョン履歴と更新については、CHANGELOG.mdをご覧ください。

📄 ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細はLICENSEファイルをご覧ください。

🙏 謝辞

• Claude Desktop と MCP を提供している Anthropic

📞 サポート

• 📖 ドキュメント
• 🐛 問題を報告
• 💬 ディスカッション

---

MCP コミュニティのために ❤️ を込めて作成"# mcp-fixer"