MCP Code Analyzer

🚀 MCP コード分析器

MCP ツールの主な目的は、プロジェクトの変更にスマートに適応することです。例えば、コードの修正や構造の調整が必要な場合、関連する他の使用も適切に更新されることを目指しています。

🚀 クイックスタート

MCP コード分析器は、Claude Desktop と統合された包括的なコード分析および管理ツールです。このツールは、プロジェクトやファイルレベルでコードを分析し、必要な変更やプロジェクトの理解に役立つ洞察を提供します。

✨ 主な機能

• プロジェクトやファイルレベルでのコード分析
• Claude Desktop との統合
• 複数の分析ツールの提供
• コードの修正やファイル操作のサポート

📦 インストール

前提条件

• Python 3.10 以上
• Windows（Linux/MacOS のサポートは未テスト）

インストール手順

# リポジトリをクローンする
git clone https://github.com/[your-username]/mcp-code-analyzer.git
cd mcp-code-analyzer

# 依存関係とパッケージをインストールする
pip install -e .

💻 使用例

基本的な使用法

Claude Desktop との統合設定

{
  "globalShortcut": "Ctrl+Space",
  "mcpServers": {
    "code-analyzer": {
      "command": "python",
      "args": [
        "-m",
        "mcp_code_analyzer",
        "--analyze-paths",
        "C:\\Projects\\path1"
      ],
      "type": "module"
    }
  }
}

高度な使用法

複数のプロジェクトパスの指定

{
  "globalShortcut": "Ctrl+Space",
  "mcpServers": {
    "code-analyzer": {
      "command": "python",
      "args": [
        "-m",
        "mcp_code_analyzer",
        "--analyze-paths",
        "C:\\Projects\\path1",
        "C:\\Projects\\path2"
      ],
      "type": "module"
    }
  }
}

📚 ドキュメント

Claude Desktop 統合

設定

1. Claude Desktop の設定にアクセスします：

   Win + R → %AppData%\Claude\
   

2. claude_desktop_config.json を作成または編集します。

パス設定

• 複数のプロジェクトパスを指定できます。
• チャットメッセージを通じて、他の追加パスやファイルを分析できます。
• 分析可能なパスやファイルの数に制限はありません。

🛠️ ツールと状態

実装済みツール

• ✅ プロジェクト分析

  • analyze_project_structure（XML ツリー形式）
  • analyze_project_statistics
  • analyze_project_technology
  • analyze_code_structure

• ✅ コード分析

  • analyze_imports
  • analyze_file
  • find_references

• ⚠️🔄 ファイル操作（使用前に必ずバックアップを取ってください）

  • file_operations
  • version_control（作成日付のバックアップ）

• ⚠️🔄 コード修正（使用前に必ずバックアップを取ってください）

  • code_modifier（行単位でコードを修正）（現在重大な問題があります）

テスト段階

• 🔄 check_syntax
• 🔄 find_code_patterns
• 🔄 find_pattern_usages
• 🔄 search_content
• 🔄 search_files
• 🔄 validate_code

既知の問題

1. Chat コンテキストの制限により、大きなファイルの修正が中断されることがあります。
2. AI が生成したドキュメントコメントが、大型ファイルのコード操作に影響を与えることがあります。

デモビデオ

MCP ツールを使用してマリオゲームを構築するデモをご覧ください：

注意：このビデオはツールの機能を示していますが、完全なチュートリアルではありません。Claude のメッセージ制限により、ゲームを完全にプレイすることはできませんが、MCP ツールの動作原理と実行可能な操作を示しています。

貢献

貢献を歓迎します！バグ報告、機能要求、ドキュメントの改善、コードの貢献など、すべての貢献が大切です。リポジトリをフォークして、プルリクエストを送信してください。

📄 ライセンス

このプロジェクトは MIT License に基づいて配布されています。詳細については、LICENSE ファイルを参照してください。

⚠️ 重要提示

このツールはファイル操作を実行するため、ファイルを変更または削除する可能性があります。変更機能を使用する前に、必ずコードベースをバックアップしてください。

💡 使用建议

コード修正やファイル操作を行う際には、事前にバックアップを取ることをおすすめします。また、既知の問題に注意して使用してください。