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!