DevMatin/mcp-server-typescript

MCP Server TypeScript

Ein moderner MCP (Model Context Protocol) Server für DataForSEO APIs, entwickelt in TypeScript.

📁 Projektstruktur

mcp-server-typescript/
├── 📁 src/                          # Quellcode
│   ├── 📁 core/                     # Kernfunktionalitäten
│   │   ├── 📁 client/              # API-Client
│   │   ├── 📁 config/              # Konfiguration
│   │   ├── 📁 modules/             # API-Module
│   │   └── 📁 utils/               # Hilfsfunktionen
│   ├── 📁 main/                    # Hauptanwendung
│   └── 📁 worker/                  # Worker-Prozesse
├── 📁 apis/                        # API-Definitionen
│   ├── 📁 core/                    # Kern-APIs
│   │   ├── SERP_API.ts
│   │   └── On_Page_API.ts
│   ├── 📁 analytics/               # Analytics-APIs
│   │   ├── Domain_Analytics_API.ts
│   │   ├── DataForSEO_Labs_API.ts
│   │   └── Business_Data_API.ts
│   ├── 📁 content/                 # Content-APIs
│   │   ├── Content_Generation_API.ts
│   │   └── Content_Analysis_API.ts
│   ├── 📁 commerce/                # Commerce-APIs
│   │   ├── Merchant_API.ts
│   │   └── Google_Shopping_API.ts
│   └── index.ts                    # API-Index
├── 📁 tests/                       # Tests
│   ├── test-mcp-server.js
│   ├── test-tool.js
│   └── simple-test.js
├── 📁 examples/                    # Beispiele
│   ├── api-integration-template.ts
│   └── keyword-research-kaffee-erlangen.js
├── 📁 docs/                        # Dokumentation
│   ├── 01_SERP_API.md
│   ├── 02_Keyword_Data_API.md
│   ├── 03_On_Page_API.md
│   ├── 04_Domain_Analytics_API.md
│   ├── 05_Content_Analysis_API.md
│   ├── 06_Content_Generation_API.md
│   ├── 07_Business_Data_API.md
│   ├── 08_Merchant_API.md
│   └── 09_Google_Shopping_API.md
├── 📁 config/                      # Konfigurationsdateien
│   ├── tsconfig.json
│   ├── tsconfig.worker.json
│   └── wrangler.jsonc
├── 📁 scripts/                     # Build-Scripts
├── 📁 build/                       # Kompilierte Dateien
└── 📄 package.json                 # Projekt-Konfiguration

🚀 Schnellstart

Voraussetzungen

• Node.js 18+
• npm oder yarn

Installation

# Repository klonen
git clone <repository-url>
cd mcp-server-typescript

# Abhängigkeiten installieren
npm install

# Projekt kompilieren
npm run build

# Server starten
npm start

Konfiguration

1. Erstelle eine .env Datei im Root-Verzeichnis:

DATAFORSEO_USERNAME=your_username
DATAFORSEO_PASSWORD=your_password
ENABLED_MODULES=SERP,KEYWORDS_DATA,ONPAGE,DATAFORSEO_LABS,BACKLINKS,BUSINESS_DATA,DOMAIN_ANALYTICS
DATAFORSEO_FULL_RESPONSE=false

2. Oder verwende die Konfigurationsdatei config/field-config.example.json

📚 API-Module

Core APIs

• SERP API: Suchmaschinen-Ergebnisse abrufen
• On-Page API: On-Page SEO-Analysen

Analytics APIs

• Domain Analytics: Domain-basierte Analysen
• DataForSEO Labs: Erweiterte Forschungs-Tools
• Business Data: Geschäftsdaten und Informationen

Content APIs

• Content Generation: KI-gestützte Content-Erstellung
• Content Analysis: Content-Analysen und Optimierung

Commerce APIs

• Merchant API: E-Commerce-Daten
• Google Shopping: Google Shopping-Integration

🧪 Tests

# Alle Tests ausführen
npm test

# Spezifische Tests
node tests/test-mcp-server.js
node tests/test-tool.js

📖 Dokumentation

Detaillierte API-Dokumentation findest du im docs/ Verzeichnis:

🔧 Entwicklung

Build-Prozess

# TypeScript kompilieren
npm run build

# Development-Modus
npm run dev

# Worker kompilieren
npm run build:worker

Code-Struktur

• Modulare Architektur: Jede API ist in einem separaten Modul organisiert
• TypeScript: Vollständige Typisierung für bessere Entwicklererfahrung
• MCP-Protokoll: Standardkonforme Implementierung des Model Context Protocol

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Siehe für Details.

🤝 Beitragen

1. Fork das Repository
2. Erstelle einen Feature-Branch (git checkout -b feature/amazing-feature)
3. Committe deine Änderungen (git commit -m 'Add some amazing feature')
4. Push zum Branch (git push origin feature/amazing-feature)
5. Öffne einen Pull Request

📞 Support

Bei Fragen oder Problemen:

• Erstelle ein Issue im GitHub Repository
• Konsultiere die Dokumentation im docs/ Verzeichnis
• Überprüfe die Beispiele im examples/ Verzeichnis