MCP Fixer

🚀 🔧 MCP Fixer Server

Claude DesktopのModel Context Protocol (MCP) サーバー用の包括的な診断と修復ツールです。一般的な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構文、パス、サーバー設定の検証
• 📊 サーバーステータス監視 - 個々のMCPサーバーのリアルタイムヘルスチェック
• ⚙️ 依存関係検証 - Node.js、npm、Python、UVが適切にインストールされていることを確認
• 🌐 ポート競合検出 - 一般的なMCPポートでのネットワーク競合を特定
• 🔧 自動構文修正 - 自動バックアップを作成しながらJSONエラーを修復
• 📝 ログファイル解析 - MCPログを解析してエラーパターンと洞察を得る
• 💡 スマートな提案 - ターゲットとなる修正提案を提供
• 🛡️ 安全第一 - 変更を加える前にバックアップを作成

📦 利用可能なツール

🎯 検出される一般的な問題

• 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ファイルを参照してください。

🙏 謝辞

• Claude DesktopとMCPを提供するAnthropic
• Model Context Protocolコミュニティ
• フィードバックを提供するすべてのコントリビューターとユーザー

📞 サポート

• 📖 ドキュメント
• 🐛 問題報告
• 💬 ディスカッション
• 📧 メール: support@yourproject.com

Made with ❤️ for the MCP community"# mcp-fixer"