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
- Repository'yi klonlayın:
git clone https://github.com/code-alchemist01/development-tools-mcp-Server.git
cd development-tools-mcp-Server
- Bağımlılıkları yükleyin:
npm install
- Playwright browser'larını yükleyin (dynamic scraping için):
npx playwright install chromium
- Projeyi derleyin:
npm run build
- 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 analizicalculate_complexity- Cyclomatic complexity hesaplamadetect_code_smells- Code smell tespitianalyze_maintainability- Maintainability index hesaplamafind_duplicate_code- Duplicate kod tespitianalyze_test_coverage- Test coverage analizigenerate_code_metrics- Detaylı kod metriklerisuggest_refactoring- Refactoring önerileri
Linting Tools (5)
lint_code- ESLint ile kod kontrolüformat_code- Prettier ile kod formatlamacheck_typescript- TypeScript type checkingvalidate_syntax- Syntax doğrulamafix_lint_issues- Otomatik lint düzeltmeleri
Dependency Analysis Tools (6)
analyze_dependencies- Bağımlılık ağacı analizifind_unused_dependencies- Kullanılmayan paketleri bulcheck_vulnerabilities- Güvenlik açığı kontrolücheck_outdated_packages- Eski paketleri tespit etanalyze_bundle_size- Bundle boyutu analizisuggest_dependency_updates- Güncelleme önerileri
Security Analysis Tools (4)
scan_security_issues- Güvenlik taramasıdetect_secrets- Hardcoded secret'ları bulanalyze_permissions- Dosya izin analizicheck_compliance- Compliance kontrolü
Static Scraping Tools (6)
scrape_html- HTML içeriği çekmeextract_text- Metin çıkarmaextract_links- Link çıkarmaextract_images- Görsel URL'leri çıkarmaextract_tables- Tablo verilerini çıkarmascrape_by_selector- CSS selector ile scraping
Dynamic Scraping Tools (5)
scrape_dynamic_content- JavaScript render edilmiş içerikscrape_with_interaction- Kullanıcı etkileşimi ile scrapingscreenshot_page- Sayfa ekran görüntüsüwait_for_element- Element beklemeextract_after_click- Tıklama sonrası içerik çekme
API Discovery Tools (4)
discover_api_endpoints- API endpoint keşfianalyze_network_requests- Network trafiği analiziextract_api_schema- API şema çıkarmatest_api_endpoint- API endpoint testi
Data Processing Tools (4)
parse_json- JSON parsingparse_xml- XML parsingparse_csv- CSV parsingformat_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
- Fork edin
- Feature branch oluşturun (
git checkout -b feature/amazing-feature) - Commit edin (
git commit -m 'Add amazing feature') - Push edin (
git push origin feature/amazing-feature) - 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!