MCP Code Analyzer

MCP コードアナライザー

MCP ツールの主な目的は、プロジェクトの変更にインテリジェントに対応することです。
たとえば、コードの変更や構造の調整が必要な場合、関連するほかの箇所も適切に更新されるようにします。

現在、このプロジェクトには多くのバグがあり、ツールが期待どおりに動作しないことがあります。仕事の都合で、あまり時間を割けませんが、時間が取れたときに問題を修正し、正常に動作する状態にできるよう努めます。

⚠️ 警告：バックアップを推奨します
このツールは、ファイルの変更や削除につながる可能性のあるファイル操作を実行します。変更機能を使用する前に、必ずコードベースをバックアップしてください。

概要

Model Context Protocol（MCP）Code Analyzer は、Claude Desktop と連携する包括的なコード分析・管理ツールです。プロジェクトレベルとファイルレベルの両方でコードを分析し、必要な変更やプロジェクトの理解に役立つ情報を提供します。

前提条件

• Python 3.10 以降
• Windows（Linux／MacOS のサポートは未検証です）

インストール

# Clone the repository
git clone https://github.com/[your-username]/mcp-code-analyzer.git
cd mcp-code-analyzer

# Install dependencies and package
pip install -e .

Claude Desktop との連携

設定

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

   Win + R → %AppData%\Claude\
   

2. claude_desktop_config.json を作成／編集します：

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

パスの設定

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

🛠️ ツールとステータス

動作中のツール

• ✅ プロジェクト分析

  • 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（コードを1行ずつ変更します）（現在、大きな問題があります）

テスト中の機能

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

既知の問題

1. チャットのコンテキスト制限により、大きなファイルの変更が中断されることがあります
2. AI が生成するドキュメント用コメントが、大きなファイルのコード動作に影響することがあります

デモ動画

Mario ゲームの作成に MCP ツールを使用するデモをご覧ください：

注：これはツールの機能を示すデモであり、ゲーム制作の完全なチュートリアルではありません。Claude のメッセージ制限によりゲームは完全にはプレイできませんが、この動画では MCP ツールの仕組みと、ツールでできることを紹介しています。

コントリビューション

コントリビューションを歓迎します！バグ報告、機能リクエスト、ドキュメントの改善、コードの提供など、どのような貢献も役立ちます。リポジトリをフォークして、プルリクエストを送信してください。

ライセンス

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

---

注：このプロジェクトは現在も活発に開発中です。機能やドキュメントは頻繁に変更される可能性があります。