# MCP Development Tools Server

[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)
[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
[![MCP](https://img.shields.io/badge/MCP-1.0-orange.svg)](https://modelcontextprotocol.io/)

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:**
```bash
git clone https://github.com/code-alchemist01/development-tools-mcp-Server.git
cd development-tools-mcp-Server
```

2. **Bağımlılıkları yükleyin:**
```bash
npm install
```

3. **Playwright browser'larını yükleyin (dynamic scraping için):**
```bash
npx playwright install chromium
```

4. **Projeyi derleyin:**
```bash
npm run build
```

5. **Test edin:**
```bash
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

```json
{
  "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

```json
{
  "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:**
```json
{
  "mcpServers": {
    "development-tools": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {}
    }
  }
}
```

**Environment Variables ile:**
```json
{
  "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

```bash
npm run dev
```

### Build

```bash
npm run build
```

### Test

```bash
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](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](https://modelcontextprotocol.io/) - MCP standardı için
- [Cursor](https://cursor.sh/) - MCP desteği için
- [Claude](https://claude.ai/) - 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!**