mcp-codebase-oracle 0.1.0__tar.gz

mcp_codebase_oracle-0.1.0/.gitignore

@@ -0,0 +1,50 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg
+*.egg-info/
+dist/
+build/
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# uv
+.python-version
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+htmlcov/
+.coverage
+.coverage.*
+coverage.xml
+
+# Type checking
+.mypy_cache/
+
+# Cache
+.oracle_cache/
+*.diskcache/
+
+# Environment
+.env
+.env.local
+
+# Ruff
+.ruff_cache/

mcp_codebase_oracle-0.1.0/PKG-INFO

@@ -0,0 +1,203 @@
+Metadata-Version: 2.4
+Name: mcp-codebase-oracle
+Version: 0.1.0
+Summary: 🔮 MCP sunucusu — Herhangi bir codebase'i analiz et, mimariyi çıkar, etki analizi yap
+Project-URL: Homepage, https://github.com/mcp-codebase-oracle/mcp-codebase-oracle
+Project-URL: Repository, https://github.com/mcp-codebase-oracle/mcp-codebase-oracle
+Project-URL: Issues, https://github.com/mcp-codebase-oracle/mcp-codebase-oracle/issues
+Author: MCP Codebase Oracle Contributors
+License: MIT
+Keywords: architecture,ast,code-intelligence,codebase-analysis,dependency-graph,impact-analysis,legacy-code,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Requires-Dist: diskcache>=5.6
+Requires-Dist: gitpython>=3.1
+Requires-Dist: mcp[cli]>=1.2.0
+Requires-Dist: networkx>=3.2
+Requires-Dist: pathspec>=0.12
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: rich>=13.0
+Provides-Extra: all
+Requires-Dist: mypy>=1.10; extra == 'all'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'all'
+Requires-Dist: pytest-cov>=5.0; extra == 'all'
+Requires-Dist: pytest>=8.0; extra == 'all'
+Requires-Dist: ruff>=0.5; extra == 'all'
+Requires-Dist: tree-sitter-javascript>=0.23; extra == 'all'
+Requires-Dist: tree-sitter-python>=0.23; extra == 'all'
+Requires-Dist: tree-sitter-typescript>=0.23; extra == 'all'
+Requires-Dist: tree-sitter>=0.24; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Provides-Extra: tree-sitter
+Requires-Dist: tree-sitter-javascript>=0.23; extra == 'tree-sitter'
+Requires-Dist: tree-sitter-python>=0.23; extra == 'tree-sitter'
+Requires-Dist: tree-sitter-typescript>=0.23; extra == 'tree-sitter'
+Requires-Dist: tree-sitter>=0.24; extra == 'tree-sitter'
+Description-Content-Type: text/markdown
+
+# 🔮 MCP Codebase Oracle
+
+> **"Bu kodu kim yazdı, ne yapıyor anlamıyorum" sorusunu tarihe gömüyoruz.**
+
+MCP Codebase Oracle, herhangi bir yazılım projesini analiz eden, mimari yapıyı çıkaran ve kod değişikliklerinin etkisini önceden gösteren bir **Model Context Protocol (MCP)** sunucusudur.
+
+## ✨ Özellikler
+
+| Özellik | Açıklama |
+|---------|----------|
+| 🏗️ **Mimari Tespit** | MVC, Layered, Hexagonal, Clean Architecture ve diğer pattern'leri otomatik tespit |
+| 🕸️ **Bağımlılık Grafı** | Modüller, sınıflar ve fonksiyonlar arası ilişki haritası |
+| 💥 **Etki Analizi** | "Bu kodu değiştirirsem ne bozulur?" sorusuna kesin cevap |
+| 📊 **Karmaşıklık Metrikleri** | Cyclomatic, cognitive complexity ve maintainability index |
+| 🔍 **Sembol Arama** | Fonksiyon, sınıf, değişken arama ve detay görüntüleme |
+| 📖 **Kod Açıklama** | Dosya ve fonksiyon bazlı insan tarafından anlaşılır açıklamalar |
+| 🎯 **Dead Code Tespiti** | Kullanılmayan kod parçalarını bulma |
+| 🌊 **Görselleştirme** | Mermaid diyagramları ile grafik çıktılar |
+
+## 🚀 Kurulum
+
+### uv ile (önerilen)
+
+```bash
+# Projeyi klonla
+git clone https://github.com/mcp-codebase-oracle/mcp-codebase-oracle.git
+cd mcp-codebase-oracle
+
+# Bağımlılıkları kur
+uv sync
+
+# Çalıştır
+uv run mcp-codebase-oracle
+```
+
+### pip ile
+
+```bash
+pip install mcp-codebase-oracle
+```
+
+### Docker ile
+
+```bash
+docker build -t mcp-codebase-oracle .
+docker run -v /path/to/project:/project:ro mcp-codebase-oracle
+```
+
+## ⚡ MCP İstemci Konfigürasyonu
+
+### Claude Desktop
+
+`claude_desktop_config.json` dosyasına ekle:
+
+```json
+{
+  "mcpServers": {
+    "codebase-oracle": {
+      "command": "uv",
+      "args": [
+        "--directory", "/path/to/mcp-codebase-oracle",
+        "run", "mcp-codebase-oracle"
+      ]
+    }
+  }
+}
+```
+
+### VS Code (Copilot / Continue)
+
+```json
+{
+  "mcp.servers": {
+    "codebase-oracle": {
+      "command": "mcp-codebase-oracle",
+      "args": []
+    }
+  }
+}
+```
+
+## 🔧 Kullanılabilir Tool'lar
+
+### Tarama & İndeksleme
+- `scan_project` — Proje tarama ve indeksleme
+- `rescan_project` — Incremental güncelleme
+- `get_project_summary` — Proje özeti
+
+### Sorgulama
+- `find_symbol` — Fonksiyon/sınıf/değişken arama
+- `get_symbol_detail` — Sembol detayları
+- `search_code` — Kod içi arama
+- `get_file_overview` — Dosya yapı özeti
+
+### Graf Analizi
+- `get_dependency_graph` — Bağımlılık grafı
+- `get_call_graph` — Fonksiyon çağrı grafı
+- `get_class_hierarchy` — Sınıf hiyerarşisi
+- `find_circular_dependencies` — Döngüsel bağımlılık tespiti
+
+### Etki Analizi
+- `analyze_impact` — Değişiklik etki analizi
+- `what_if_delete` — Silme senaryosu
+- `what_if_rename` — Yeniden adlandırma senaryosu
+- `find_dead_code` — Kullanılmayan kod tespiti
+
+### Mimari
+- `detect_architecture` — Mimari pattern tespiti
+- `get_module_coupling` — Modül bağlılık metrikleri
+- `detect_code_smells` — Kod kokusu tespiti
+
+### Açıklama & Görselleştirme
+- `explain_file` — Dosya açıklama
+- `explain_function` — Fonksiyon açıklama
+- `generate_onboarding_guide` — Onboarding rehberi
+- `generate_architecture_diagram` — Mimari diyagram
+- `generate_dependency_matrix` — Bağımlılık matrisi
+- `generate_hotspot_map` — Hotspot haritası
+
+## 🗣️ Desteklenen Diller
+
+| Dil | Parser | Durum |
+|-----|--------|-------|
+| Python | `ast` (native) | ✅ Tam destek |
+| JavaScript/TypeScript | tree-sitter | 🔜 Yakında |
+| Java | tree-sitter | 🔜 Yakında |
+| Go | tree-sitter | 🔜 Yakında |
+| Rust | tree-sitter | 🔜 Yakında |
+| C# | tree-sitter | 🔜 Yakında |
+| Diğerleri | regex (generic) | ⚡ Temel destek |
+
+## 🛠️ Geliştirme
+
+```bash
+# Dev bağımlılıklarını kur
+uv sync --extra dev
+
+# Testleri çalıştır
+uv run pytest -v
+
+# Linting
+uv run ruff check src/ tests/
+
+# Type checking
+uv run mypy src/
+
+# MCP Inspector ile test
+uv run mcp dev src/mcp_codebase_oracle/server.py
+```
+
+## 📄 Lisans
+
+MIT License — Detaylar için [LICENSE](LICENSE) dosyasına bakın.

mcp_codebase_oracle-0.1.0/README.md

@@ -0,0 +1,153 @@
+# 🔮 MCP Codebase Oracle
+
+> **"Bu kodu kim yazdı, ne yapıyor anlamıyorum" sorusunu tarihe gömüyoruz.**
+
+MCP Codebase Oracle, herhangi bir yazılım projesini analiz eden, mimari yapıyı çıkaran ve kod değişikliklerinin etkisini önceden gösteren bir **Model Context Protocol (MCP)** sunucusudur.
+
+## ✨ Özellikler
+
+| Özellik | Açıklama |
+|---------|----------|
+| 🏗️ **Mimari Tespit** | MVC, Layered, Hexagonal, Clean Architecture ve diğer pattern'leri otomatik tespit |
+| 🕸️ **Bağımlılık Grafı** | Modüller, sınıflar ve fonksiyonlar arası ilişki haritası |
+| 💥 **Etki Analizi** | "Bu kodu değiştirirsem ne bozulur?" sorusuna kesin cevap |
+| 📊 **Karmaşıklık Metrikleri** | Cyclomatic, cognitive complexity ve maintainability index |
+| 🔍 **Sembol Arama** | Fonksiyon, sınıf, değişken arama ve detay görüntüleme |
+| 📖 **Kod Açıklama** | Dosya ve fonksiyon bazlı insan tarafından anlaşılır açıklamalar |
+| 🎯 **Dead Code Tespiti** | Kullanılmayan kod parçalarını bulma |
+| 🌊 **Görselleştirme** | Mermaid diyagramları ile grafik çıktılar |
+
+## 🚀 Kurulum
+
+### uv ile (önerilen)
+
+```bash
+# Projeyi klonla
+git clone https://github.com/mcp-codebase-oracle/mcp-codebase-oracle.git
+cd mcp-codebase-oracle
+
+# Bağımlılıkları kur
+uv sync
+
+# Çalıştır
+uv run mcp-codebase-oracle
+```
+
+### pip ile
+
+```bash
+pip install mcp-codebase-oracle
+```
+
+### Docker ile
+
+```bash
+docker build -t mcp-codebase-oracle .
+docker run -v /path/to/project:/project:ro mcp-codebase-oracle
+```
+
+## ⚡ MCP İstemci Konfigürasyonu
+
+### Claude Desktop
+
+`claude_desktop_config.json` dosyasına ekle:
+
+```json
+{
+  "mcpServers": {
+    "codebase-oracle": {
+      "command": "uv",
+      "args": [
+        "--directory", "/path/to/mcp-codebase-oracle",
+        "run", "mcp-codebase-oracle"
+      ]
+    }
+  }
+}
+```
+
+### VS Code (Copilot / Continue)
+
+```json
+{
+  "mcp.servers": {
+    "codebase-oracle": {
+      "command": "mcp-codebase-oracle",
+      "args": []
+    }
+  }
+}
+```
+
+## 🔧 Kullanılabilir Tool'lar
+
+### Tarama & İndeksleme
+- `scan_project` — Proje tarama ve indeksleme
+- `rescan_project` — Incremental güncelleme
+- `get_project_summary` — Proje özeti
+
+### Sorgulama
+- `find_symbol` — Fonksiyon/sınıf/değişken arama
+- `get_symbol_detail` — Sembol detayları
+- `search_code` — Kod içi arama
+- `get_file_overview` — Dosya yapı özeti
+
+### Graf Analizi
+- `get_dependency_graph` — Bağımlılık grafı
+- `get_call_graph` — Fonksiyon çağrı grafı
+- `get_class_hierarchy` — Sınıf hiyerarşisi
+- `find_circular_dependencies` — Döngüsel bağımlılık tespiti
+
+### Etki Analizi
+- `analyze_impact` — Değişiklik etki analizi
+- `what_if_delete` — Silme senaryosu
+- `what_if_rename` — Yeniden adlandırma senaryosu
+- `find_dead_code` — Kullanılmayan kod tespiti
+
+### Mimari
+- `detect_architecture` — Mimari pattern tespiti
+- `get_module_coupling` — Modül bağlılık metrikleri
+- `detect_code_smells` — Kod kokusu tespiti
+
+### Açıklama & Görselleştirme
+- `explain_file` — Dosya açıklama
+- `explain_function` — Fonksiyon açıklama
+- `generate_onboarding_guide` — Onboarding rehberi
+- `generate_architecture_diagram` — Mimari diyagram
+- `generate_dependency_matrix` — Bağımlılık matrisi
+- `generate_hotspot_map` — Hotspot haritası
+
+## 🗣️ Desteklenen Diller
+
+| Dil | Parser | Durum |
+|-----|--------|-------|
+| Python | `ast` (native) | ✅ Tam destek |
+| JavaScript/TypeScript | tree-sitter | 🔜 Yakında |
+| Java | tree-sitter | 🔜 Yakında |
+| Go | tree-sitter | 🔜 Yakında |
+| Rust | tree-sitter | 🔜 Yakında |
+| C# | tree-sitter | 🔜 Yakında |
+| Diğerleri | regex (generic) | ⚡ Temel destek |
+
+## 🛠️ Geliştirme
+
+```bash
+# Dev bağımlılıklarını kur
+uv sync --extra dev
+
+# Testleri çalıştır
+uv run pytest -v
+
+# Linting
+uv run ruff check src/ tests/
+
+# Type checking
+uv run mypy src/
+
+# MCP Inspector ile test
+uv run mcp dev src/mcp_codebase_oracle/server.py
+```
+
+## 📄 Lisans
+
+MIT License — Detaylar için [LICENSE](LICENSE) dosyasına bakın.

mcp_codebase_oracle-0.1.0/mcp_codebase_oracle/__init__.py

@@ -0,0 +1,4 @@
+"""MCP Codebase Oracle — Herhangi bir codebase'i analiz et, mimariyi çıkar, etki analizi yap."""
+
+__version__ = "0.1.0"
+__app_name__ = "mcp-codebase-oracle"

mcp_codebase_oracle-0.1.0/mcp_codebase_oracle/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for running the package as a module: python -m mcp_codebase_oracle"""
+
+from mcp_codebase_oracle.server import main
+
+if __name__ == "__main__":
+    main()

mcp_codebase_oracle-0.1.0/mcp_codebase_oracle/config.py

@@ -0,0 +1,145 @@
+"""Konfigürasyon yönetimi — environment variables ve default değerler."""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass, field
+from pathlib import Path
+
+from platformdirs import user_cache_dir
+
+from mcp_codebase_oracle import __app_name__
+
+# Default exclude patterns (always excluded in addition to .gitignore)
+DEFAULT_EXCLUDE_PATTERNS: list[str] = [
+    "node_modules",
+    ".git",
+    "__pycache__",
+    ".venv",
+    "venv",
+    ".tox",
+    ".mypy_cache",
+    ".pytest_cache",
+    ".ruff_cache",
+    "dist",
+    "build",
+    "*.egg-info",
+    ".oracle_cache",
+]
+
+# Language extension mapping
+LANGUAGE_EXTENSIONS: dict[str, str] = {
+    ".py": "python",
+    ".pyi": "python",
+    ".js": "javascript",
+    ".jsx": "javascript",
+    ".ts": "typescript",
+    ".tsx": "typescript",
+    ".java": "java",
+    ".go": "go",
+    ".rs": "rust",
+    ".cs": "csharp",
+    ".rb": "ruby",
+    ".php": "php",
+    ".swift": "swift",
+    ".kt": "kotlin",
+    ".scala": "scala",
+    ".c": "c",
+    ".cpp": "cpp",
+    ".h": "c",
+    ".hpp": "cpp",
+    ".lua": "lua",
+    ".r": "r",
+    ".R": "r",
+    ".sh": "shell",
+    ".bash": "shell",
+    ".zsh": "shell",
+    ".yml": "yaml",
+    ".yaml": "yaml",
+    ".json": "json",
+    ".toml": "toml",
+    ".xml": "xml",
+    ".html": "html",
+    ".css": "css",
+    ".scss": "scss",
+    ".sql": "sql",
+    ".md": "markdown",
+    ".rst": "restructuredtext",
+}
+
+# Supported parsable languages (languages with dedicated parsers)
+PARSABLE_LANGUAGES: set[str] = {
+    "python",
+    # Future: "javascript", "typescript", "java", "go", "rust", "csharp"
+}
+
+
+@dataclass
+class OracleConfig:
+    """Ana konfigürasyon sınıfı — tüm ayarlar burada."""
+
+    # Cache directory (platform-specific default)
+    cache_dir: Path = field(default_factory=lambda: Path(user_cache_dir(__app_name__)))
+
+    # Maximum file size to parse (bytes) — default 5MB
+    max_file_size: int = 5 * 1024 * 1024
+
+    # Maximum number of files to index
+    max_files: int = 100_000
+
+    # Log level
+    log_level: str = "INFO"
+
+    # Extra exclude patterns (added to defaults)
+    extra_exclude_patterns: list[str] = field(default_factory=list)
+
+    # Git integration enabled
+    git_enabled: bool = True
+
+    @property
+    def exclude_patterns(self) -> list[str]:
+        """Combine default and extra exclude patterns."""
+        return DEFAULT_EXCLUDE_PATTERNS + self.extra_exclude_patterns
+
+    @classmethod
+    def from_env(cls) -> OracleConfig:
+        """Create config from environment variables with fallback to defaults."""
+        config = cls()
+
+        if cache_dir := os.getenv("ORACLE_CACHE_DIR"):
+            config.cache_dir = Path(cache_dir).expanduser()
+
+        if max_file_size := os.getenv("ORACLE_MAX_FILE_SIZE"):
+            config.max_file_size = int(max_file_size)
+
+        if max_files := os.getenv("ORACLE_MAX_FILES"):
+            config.max_files = int(max_files)
+
+        if log_level := os.getenv("ORACLE_LOG_LEVEL"):
+            config.log_level = log_level.upper()
+
+        if exclude := os.getenv("ORACLE_EXCLUDE_PATTERNS"):
+            config.extra_exclude_patterns = [p.strip() for p in exclude.split(",")]
+
+        if git_enabled := os.getenv("ORACLE_GIT_ENABLED"):
+            config.git_enabled = git_enabled.lower() in ("true", "1", "yes")
+
+        return config
+
+
+# Global config instance — lazy initialized
+_config: OracleConfig | None = None
+
+
+def get_config() -> OracleConfig:
+    """Get or create global config instance."""
+    global _config
+    if _config is None:
+        _config = OracleConfig.from_env()
+    return _config
+
+
+def reset_config() -> None:
+    """Reset global config (useful for testing)."""
+    global _config
+    _config = None

mcp_codebase_oracle-0.1.0/mcp_codebase_oracle/core/__init__.py

@@ -0,0 +1 @@
+"""Çekirdek analiz motorları."""