MCP コードベース インサイト - WIP

🚧開発進行中

このプロジェクトは現在活発に開発中です。機能とドキュメントは継続的に更新されています。

概要

MCP Codebase Insight は、セマンティック分析、パターン検出、ドキュメント管理を通じてコードベースを分析および理解するためのシステムです。

Related MCP server: CodeAlive MCP

現在の開発状況

完成した機能

• ✅ コアベクターストアシステム

• ✅ 基本的な知識ベース

• ✅ SSE統合

• ✅ テストフレームワーク

• ✅ TDD とデバッグ フレームワーク (rules_template の統合)

進行中

• 🔄 ドキュメント管理システム

• 🔄高度なパターン検出

• 🔄パフォーマンスの最適化

• 🔄統合テスト

• 🔄 デバッグユーティリティの機能強化

計画済み

• 📋 拡張APIドキュメント

• 📋 カスタムパターンプラグイン

• 📋 高度なキャッシュ戦略

• 📋 デプロイメントガイド

• 📋 包括的なエラー追跡システム

クイックスタート

1. インストール

   pip install mcp-codebase-insight

2. 基本的な使い方

   from mcp_codebase_insight import CodebaseAnalyzer
   
   analyzer = CodebaseAnalyzer()
   results = analyzer.analyze_code("path/to/code")

3. テストの実行

   # Run all tests
   pytest tests/
   
   # Run unit tests
   pytest tests/unit/
   
   # Run component tests
   pytest tests/components/
   
   # Run tests with coverage
   pytest tests/ --cov=src --cov-report=term-missing

4. デバッグユーティリティ

   from mcp_codebase_insight.utils.debug_utils import debug_trace, DebugContext, get_error_tracker
   
   # Use debug trace decorator
   @debug_trace
   def my_function():
       # Implementation
   
   # Use debug context
   with DebugContext("operation_name"):
       # Code to debug
   
   # Track errors
   try:
       # Risky operation
   except Exception as e:
       error_id = get_error_tracker().record_error(e, context={"operation": "description"})
       print(f"Error recorded with ID: {error_id}")

テストとデバッグ

テスト駆動開発

このプロジェクトはテスト駆動開発 (TDD) の原則に従います。

1. 失敗するテストを最初に書く（赤）

2. テストに合格するために最小限のコードを書く（緑）

3. テストをパスさせながらクリーンなコードにリファクタリングする (リファクタリング)

TDD ドキュメントはdocs/tdd/workflow.mdにあります。

デバッグフレームワーク

私たちはAgansの9つのデバッグルールを使用します。

1. システムを理解する

2. 失敗させる

3. 考えるのをやめて見よう

4. 分割統治

5. 一度に一つずつ変えていく

6. 監査証跡を保存する

7. プラグをチェックする

8. 新鮮な視点を得る

9. 直さなければ、直らない

デバッグ方法の詳細については、 docs/debuggers/agans_9_rules.mdをご覧ください。

ドキュメント

• システムアーキテクチャ

• コアコンポーネント

• APIリファレンス

• 開発ガイド

• ワークフロー

• TDDワークフロー

• デバッグの実践

貢献

貢献を歓迎します！詳細については貢献ガイドをご覧ください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

サポート

• 問題トラッカー

• 議論