MCP Project Manager

Akıllı Dosya ve Proje Yönetim MCP Server - AI asistanlarının proje analizi, kod metrikleri, dokümantasyon ve Git işlemlerini yönetebileceği kapsamlı bir Model Context Protocol (MCP) server.

🚀 Özellikler

📊 Proje Analizi

• Dosya yapısı analizi: Proje dizin ağacını çıkarır, dosya türlerini kategorize eder
• Bağımlılık haritası: Import/require ilişkilerini görselleştirir, circular dependency tespiti
• Teknoloji stack tespiti: Kullanılan framework'leri, kütüphaneleri otomatik tespit eder
• Proje metrikleri: Kod satır sayısı, dosya sayısı, dil dağılımı

📈 Kod Metrikleri

• Cyclomatic complexity hesaplama
• Code smell tespiti (uzun fonksiyonlar, tekrarlanan kod, magic numbers, vb.)
• Test coverage analizi

📝 Otomatik Dokümantasyon

• API dokümantasyonu oluşturma (JSDoc, Python docstrings)
• README.md otomatik güncelleme
• Changelog oluşturma ve güncelleme

🔍 Git Analizi

• Commit mesajı analizi ve öneriler
• Branch stratejisi önerileri
• Diff analizi ve değişiklik özeti

🗂️ Proje Organizasyonu

• Dosya taşıma/yerleştirme önerileri
• Dependency güncelleme kontrolü

🌍 Desteklenen Diller

• JavaScript / TypeScript
• Python
• Java
• Go
• Rust

📦 Kurulum

Gereksinimler

• Node.js 18+
• npm veya yarn

Adımlar

1. Projeyi klonlayın:

git clone https://github.com/code-alchemist01/project-managment-mcp-Server.git
cd project-managment-mcp-Server

2. Bağımlılıkları yükleyin:

npm install

3. Projeyi derleyin:

npm run build

🔧 Kullanım

MCP Server Olarak Çalıştırma

MCP server'ı çalıştırmak için:

npm start

veya development modunda:

npm run dev

Cursor için Konfigürasyon

1. Cursor ayarlarını açın (Settings)
2. MCP bölümüne gidin
3. Aşağıdaki konfigürasyonu ekleyin:

{
  "mcpServers": {
    "project-manager": {
      "command": "node",
      "args": ["/absolute/path/to/project-managment-mcp-Server/dist/index.js"]
    }
  }
}

Not: args içindeki yol, projenizin dist/index.js dosyasının tam yolunu içermelidir.

Claude Desktop için Konfigürasyon

%APPDATA%\Claude\claude_desktop_config.json dosyasını düzenleyin:

{
  "mcpServers": {
    "project-manager": {
      "command": "node",
      "args": ["/absolute/path/to/project-managment-mcp-Server/dist/index.js"]
    }
  }
}

🛠️ MCP Tools

Proje Analizi Tools

analyze_project_structure

Proje dizin yapısını analiz eder ve hiyerarşik yapıyı döner.

Parametreler:

• path (string, required): Analiz edilecek proje yolu
• depth (number, optional): Maksimum derinlik (default: 10)

detect_tech_stack

Projede kullanılan teknolojileri tespit eder.

analyze_dependencies

Import/require ilişkilerini analiz eder ve bağımlılık grafiği oluşturur.

get_project_metrics

Proje genel metriklerini hesaplar.

Kod Metrikleri Tools

calculate_complexity

Cyclomatic complexity hesaplar.

detect_code_smells

Code smell'leri tespit eder.

analyze_test_coverage

Test coverage analizi yapar.

Dokümantasyon Tools

generate_readme

README.md dosyası oluşturur/günceller.

generate_api_docs

API dokümantasyonu oluşturur.

update_changelog

CHANGELOG.md dosyasını günceller.

Git Analiz Tools

analyze_commits

Commit mesajlarını analiz eder.

suggest_branch_strategy

Branch stratejisi önerileri sunar.

analyze_diff

Git diff'i analiz eder.

Proje Organizasyon Tools

suggest_file_structure

Dosya yapısı önerileri sunar.

check_dependencies

Dependency güncellemelerini kontrol eder.

💡 Kullanım Örnekleri

Cursor veya Claude Desktop'ta

AI asistanınıza şunları sorabilirsiniz:

Bu projeyi analiz et: /path/to/project

Bu projede hangi teknolojiler kullanılıyor?

Code smell'leri bul ve öneriler sun

README oluştur

Git commit'lerini analiz et

🧪 Test

Testleri çalıştırmak için:

npm test

Gerçek proje üzerinde test:

node test-gercek-proje.mjs

📁 Proje Yapısı

mcp-project-manager/
├── src/
│   ├── index.ts                 # MCP server ana giriş noktası
│   ├── server.ts                # MCP server implementasyonu
│   ├── tools/                   # MCP tools (komutlar)
│   │   ├── project-analysis.ts
│   │   ├── code-metrics.ts
│   │   ├── documentation.ts
│   │   ├── git-analysis.ts
│   │   └── project-org.ts
│   ├── analyzers/               # Analiz motorları
│   │   ├── file-analyzer.ts
│   │   ├── dependency-analyzer.ts
│   │   ├── code-analyzer.ts
│   │   └── git-analyzer.ts
│   ├── utils/                   # Yardımcı fonksiyonlar
│   │   ├── file-utils.ts
│   │   ├── parser-utils.ts
│   │   └── formatters.ts
│   └── types/                   # TypeScript tip tanımları
│       └── index.ts
├── dist/                        # Derlenmiş JavaScript dosyaları
├── package.json
├── tsconfig.json
└── README.md

🤝 Katkıda Bulunma

Katkılarınızı bekliyoruz! Lütfen bir issue açın veya pull request gönderin.

1. Fork edin
2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Commit edin (git commit -m 'Add some amazing feature')
4. Push edin (git push origin feature/amazing-feature)
5. Pull Request açın

📄 Lisans

Bu proje MIT lisansı altında lisanslanmıştır.

🙏 Teşekkürler

• Model Context Protocol - MCP protokolü için
• Tree-sitter - Kod parsing için

🔗 İlgili Linkler

• MCP Dokümantasyonu
• Cursor IDE
• Claude Desktop

⭐ Bu projeyi beğendiyseniz yıldız vermeyi unutmayın!