MCP コードベース インサイト - WIP
🚧開発進行中
このプロジェクトは現在活発に開発中です。機能とドキュメントは継続的に更新されています。
概要
MCP Codebase Insight は、セマンティック分析、パターン検出、ドキュメント管理を通じてコードベースを分析および理解するためのシステムです。
現在の開発状況
完成した機能
- ✅ コアベクターストアシステム
- ✅ 基本的な知識ベース
- ✅ SSE統合
- ✅ テストフレームワーク
- ✅ TDD とデバッグ フレームワーク (rules_template の統合)
進行中
- 🔄 ドキュメント管理システム
- 🔄高度なパターン検出
- 🔄パフォーマンスの最適化
- 🔄統合テスト
- 🔄 デバッグユーティリティの機能強化
計画済み
- 📋 拡張APIドキュメント
- 📋 カスタムパターンプラグイン
- 📋 高度なキャッシュ戦略
- 📋 デプロイメントガイド
- 📋 包括的なエラー追跡システム
クイックスタート
- インストール
pip install mcp-codebase-insight
- 基本的な使い方
from mcp_codebase_insight import CodebaseAnalyzer
analyzer = CodebaseAnalyzer()
results = analyzer.analyze_code("path/to/code")
- テストの実行
# 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
- デバッグユーティリティ
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) の原則に従います。
- 失敗するテストを最初に書く（赤）
- テストに合格するために最小限のコードを書く（緑）
- テストをパスさせながらクリーンなコードにリファクタリングする (リファクタリング)
TDD ドキュメントはdocs/tdd/workflow.mdにあります。
デバッグフレームワーク
私たちはAgansの9つのデバッグルールを使用します。
- システムを理解する
- 失敗させる
- 考えるのをやめて見よう
- 分割統治
- 一度に一つずつ変えていく
- 監査証跡を保存する
- プラグをチェックする
- 新鮮な視点を得る
- 直さなければ、直らない
デバッグ方法の詳細については、 docs/debuggers/agans_9_rules.mdをご覧ください。
ドキュメント
貢献
貢献を歓迎します！詳細については貢献ガイドをご覧ください。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
サポート