MCP Development Tools Server

Comprehensive MCP (Model Context Protocol) server for code analysis and web scraping. Supports code quality analysis, linting, dependency analysis, static/dynamic web scraping, and API discovery.

🎯 Ne İşe Yarar?

MCP Development Tools, AI asistanlarının (Cursor, Claude Desktop, vb.) kod kalitesini analiz etmesi, web içeriklerini çekmesi ve development görevlerini gerçekleştirmesi için kapsamlı bir MCP server'dır.

Temel Özellikler

• 📊 Kod Kalitesi Analizi: Complexity, maintainability, code smells detection
• 🔍 Linting & Formatting: ESLint, Prettier, TypeScript checking
• 📦 Bağımlılık Analizi: Unused deps, vulnerabilities, outdated packages
• 🔒 Güvenlik Analizi: Secret detection, vulnerability scanning
• 🌐 Web Scraping: Static ve dynamic content scraping
• 🔎 API Keşfi: Endpoint discovery, network analysis

🚀 Kurulum

Gereksinimler

• Node.js 18 veya üzeri
• npm veya yarn
• TypeScript (dev dependency)

Adımlar

1. Repository'yi klonlayın:

git clone https://github.com/code-alchemist01/development-tools-mcp-Server.git
cd development-tools-mcp-Server

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

npm install

3. Playwright browser'larını yükleyin (dynamic scraping için):

npx playwright install chromium

4. Projeyi derleyin:

npm run build

5. Test edin:

npm start

📦 MCP Client'lara Kurulum

Cursor IDE

1. MCP Config Dosyasını Oluştur/Düzenle

Windows:

%APPDATA%\Cursor\User\globalStorage\mcp.json

macOS/Linux:

~/.config/Cursor/User/globalStorage/mcp.json

2. Config İçeriği

{
  "mcpServers": {
    "development-tools": {
      "command": "node",
      "args": [
        "C:\\Users\\YourUsername\\path\\to\\development-tools-mcp-Server\\dist\\index.js"
      ]
    }
  }
}

Not: args içindeki path'i kendi proje yolunuza göre güncelleyin.

3. Cursor'u Yeniden Başlatın

Config dosyasını kaydettikten sonra Cursor'u tamamen kapatıp yeniden açın.

4. Doğrulama

Cursor'da Settings > Tools & MCP bölümünde "development-tools" listede görünmeli ve "42 tools enabled" yazmalı.

Claude Desktop

1. MCP Config Dosyasını Oluştur/Düzenle

Windows:

%APPDATA%\Claude\claude_desktop_config.json

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

2. Config İçeriği

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

3. Claude Desktop'u Yeniden Başlatın

Diğer MCP Client'lar

Herhangi bir MCP client kullanıyorsanız, client'ın MCP server yapılandırma formatına göre aşağıdaki bilgileri kullanın:

• Command: node
• Args: [path/to/dist/index.js]
• Transport: stdio (standard input/output)

Örnek Config Formatları

Genel MCP Config:

{
  "mcpServers": {
    "development-tools": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {}
    }
  }
}

Environment Variables ile:

{
  "mcpServers": {
    "development-tools": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

🛠️ Kullanım

MCP Client'larda Kullanım

MCP server kurulduktan sonra, client'ınızın chat arayüzünde doğal dil komutları kullanarak işlemleri gerçekleştirebilirsiniz.

Code Analysis Örnekleri

Kod Kalitesi Analizi:

Bu projedeki kod kalitesini analiz et

src/**/*.ts dosyalarının kod kalitesini analiz et

Complexity Hesaplama:

src/utils klasöründeki dosyaların complexity'sini hesapla

Code Smell Tespiti:

Kodda code smell'leri bul

Duplicate Kod Bulma:

Projede duplicate kod bloklarını bul

Linting Örnekleri

Kod Lint:

src/**/*.ts dosyalarını lint et

Kod Formatla:

src/**/*.ts dosyalarını Prettier ile formatla

TypeScript Kontrolü:

TypeScript dosyalarında type hatalarını kontrol et

Dependency Analysis Örnekleri

Bağımlılık Analizi:

Proje bağımlılıklarını analiz et

Kullanılmayan Paketleri Bul:

Kullanılmayan npm paketlerini bul

Güvenlik Açıklarını Kontrol Et:

Dependency'lerdeki güvenlik açıklarını kontrol et

Web Scraping Örnekleri

HTML Scraping:

https://example.com sayfasını scrape et

Link Çıkarma:

https://example.com sayfasındaki tüm linkleri çıkar

Dynamic Content:

https://example.com sayfasını browser ile scrape et (JavaScript render)

API Endpoint Keşfi:

https://example.com sayfasındaki API endpoint'lerini keşfet

Security Analysis Örnekleri

Secret Detection:

Kodda hardcoded secret'ları bul

Güvenlik Taraması:

Güvenlik açıklarını tara

📋 MCP Tools (42 Araç)

Code Quality Tools (8)

• analyze_code_quality - Genel kod kalitesi analizi
• calculate_complexity - Cyclomatic complexity hesaplama
• detect_code_smells - Code smell tespiti
• analyze_maintainability - Maintainability index hesaplama
• find_duplicate_code - Duplicate kod tespiti
• analyze_test_coverage - Test coverage analizi
• generate_code_metrics - Detaylı kod metrikleri
• suggest_refactoring - Refactoring önerileri

Linting Tools (5)

• lint_code - ESLint ile kod kontrolü
• format_code - Prettier ile kod formatlama
• check_typescript - TypeScript type checking
• validate_syntax - Syntax doğrulama
• fix_lint_issues - Otomatik lint düzeltmeleri

Dependency Analysis Tools (6)

• analyze_dependencies - Bağımlılık ağacı analizi
• find_unused_dependencies - Kullanılmayan paketleri bul
• check_vulnerabilities - Güvenlik açığı kontrolü
• check_outdated_packages - Eski paketleri tespit et
• analyze_bundle_size - Bundle boyutu analizi
• suggest_dependency_updates - Güncelleme önerileri

Security Analysis Tools (4)

• scan_security_issues - Güvenlik taraması
• detect_secrets - Hardcoded secret'ları bul
• analyze_permissions - Dosya izin analizi
• check_compliance - Compliance kontrolü

Static Scraping Tools (6)

• scrape_html - HTML içeriği çekme
• extract_text - Metin çıkarma
• extract_links - Link çıkarma
• extract_images - Görsel URL'leri çıkarma
• extract_tables - Tablo verilerini çıkarma
• scrape_by_selector - CSS selector ile scraping

Dynamic Scraping Tools (5)

• scrape_dynamic_content - JavaScript render edilmiş içerik
• scrape_with_interaction - Kullanıcı etkileşimi ile scraping
• screenshot_page - Sayfa ekran görüntüsü
• wait_for_element - Element bekleme
• extract_after_click - Tıklama sonrası içerik çekme

API Discovery Tools (4)

• discover_api_endpoints - API endpoint keşfi
• analyze_network_requests - Network trafiği analizi
• extract_api_schema - API şema çıkarma
• test_api_endpoint - API endpoint testi

Data Processing Tools (4)

• parse_json - JSON parsing
• parse_xml - XML parsing
• parse_csv - CSV parsing
• format_scraped_data - Veri formatlama

📁 Proje Yapısı

development-tools-mcp-Server/
├── src/
│   ├── index.ts                 # MCP server ana giriş noktası
│   ├── server.ts                # MCP server implementasyonu
│   ├── tools/                   # MCP tools
│   │   ├── code-analysis.ts     # Security analysis tools
│   │   ├── code-quality.ts      # Code quality tools
│   │   ├── dependency-analysis.ts # Dependency analysis tools
│   │   ├── linting.ts           # Linting tools
│   │   ├── web-scraping.ts      # Web scraping tools
│   │   └── api-discovery.ts     # API discovery tools
│   ├── analyzers/               # Analiz motorları
│   │   ├── code-analyzer.ts     # Kod analizi
│   │   ├── complexity-analyzer.ts # Complexity analizi
│   │   ├── dependency-analyzer.ts # Bağımlılık analizi
│   │   └── security-analyzer.ts # Güvenlik analizi
│   ├── scrapers/                # Scraping motorları
│   │   ├── static-scraper.ts    # Static HTML scraping
│   │   ├── dynamic-scraper.ts  # Dynamic content scraping
│   │   └── api-scraper.ts      # API endpoint keşfi
│   ├── utils/                   # Yardımcı fonksiyonlar
│   │   ├── file-reader.ts
│   │   ├── formatters.ts
│   │   ├── validators.ts
│   │   └── linting-utils.ts
│   └── types/                   # TypeScript tip tanımları
│       └── index.ts
├── dist/                        # Derlenmiş JavaScript dosyaları
├── package.json
├── tsconfig.json
└── README.md

🔧 Geliştirme

Development Modu

npm run dev

Build

npm run build

Test

npm test

📝 Örnek Kullanım Senaryoları

Senaryo 1: Kod Kalitesi Analizi

MCP Client Chat'te:

src/**/*.ts dosyalarının kod kalitesini analiz et
En karmaşık fonksiyonları göster
Code smell'leri tespit et

Beklenen Sonuç:

• Kod kalitesi metrikleri
• Complexity analizi
• Code smell listesi
• Refactoring önerileri

Senaryo 2: Web Scraping

MCP Client Chat'te:

https://example.com sayfasını scrape et
Sayfadaki tüm linkleri çıkar
Tablo verilerini extract et

Beklenen Sonuç:

• HTML içeriği
• Link listesi
• Tablo verileri

Senaryo 3: API Keşfi

MCP Client Chat'te:

https://example.com sayfasındaki API endpoint'lerini keşfet
Network request'leri analiz et

Beklenen Sonuç:

• API endpoint listesi
• Request/response analizi
• Authentication bilgileri

Senaryo 4: Dependency Temizliği

MCP Client Chat'te:

Kullanılmayan paketleri bul
Güvenlik açıklarını kontrol et
Güncelleme önerileri yap

Beklenen Sonuç:

• Unused dependencies listesi
• Vulnerability raporu
• Update suggestions

🔐 Güvenlik

• Input validation ve sanitization
• URL validation
• Timeout yönetimi
• Error handling
• Secret detection
• SQL injection koruması

📊 Çıktı Formatları

• JSON - Structured data responses
• Markdown - Raporlar ve dokümantasyon
• CSV - Veri export
• Text - Plain text output

🤝 Katkıda Bulunma

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

📄 Lisans

MIT License - Detaylar için LICENSE dosyasına bakın.

🔗 MCP Client Desteği

Bu MCP server aşağıdaki client'lar ile uyumludur:

• ✅ Cursor IDE - Tam destek
• ✅ Claude Desktop - Tam destek
• ✅ Anthropic API - MCP protokolü üzerinden
• ✅ Diğer MCP Client'lar - Standart MCP protokolü destekleyen tüm client'lar

🙏 Teşekkürler

• Model Context Protocol - MCP standardı için
• Cursor - MCP desteği için
• Claude - MCP desteği için

📞 İletişim

Sorularınız veya önerileriniz için issue açabilirsiniz.

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