erickwendel-contributions-mcp

Ein Model Context Protocol (MCP) Server, der Tools bereitstellt, um Erick Wendels Beiträge über verschiedene Plattformen hinweg abzufragen. Fragen Sie Vorträge, Blogbeiträge und Videos mithilfe natürlicher Sprache über Claude, Cursor oder ähnliche Tools ab. Dieses Projekt wurde mit der Cursor IDE unter Verwendung des Standard-Agenten (Testversion) erstellt.

Schnellstart

Verwenden Sie diesen MCP-Server direkt mit Claude Desktop oder Cursor ohne Installation:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

Fügen Sie diese Konfiguration hinzu zu:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

• Cursor: ~/.cursor/mcp.json

Related MCP server: mintlify-mcp

Verfügbare Tools

Dieser MCP-Server bietet die folgenden Funktionen:

Tools

• get-talks: Ruft eine paginierte Liste von Vorträgen mit optionaler Filterung ab

  • Unterstützt Filterung nach ID, Titel, Sprache, Stadt, Land und Jahr

  • Kann nach Sprache, Land oder Stadt gruppierte Anzahlen zurückgeben

• get-posts: Ruft Beiträge mit optionaler Filterung und Paginierung ab

  • Unterstützt Filterung nach ID, Titel, Sprache und Portal

• get-videos: Ruft Videos mit optionaler Filterung und Paginierung ab

  • Unterstützt Filterung nach ID, Titel und Sprache

• check-status: Überprüft, ob die API aktiv ist und antwortet

Prompts

• find-content: Generiert Abfragen, um spezifische Inhalte nach Typ, Thema und Sprache zu finden

• summarize-activity: Erstellt Zusammenfassungen der Inhaltsaktivität nach Jahr

Ressourcen

• erickwendel://about: Serverinformationen und Metadaten zu den Funktionen

• erickwendel://statistics: Inhaltsstatistiken und verfügbare Abfragen

Integration mit KI-Tools

MCP-Server-Funktionen untersuchen

Sie können die Funktionen dieses MCP-Servers mit dem MCP Inspector untersuchen:

npm run inspect

Dies zeigt Ihnen alle verfügbaren Tools, deren Parameter und wie man sie verwendet.

Einrichtung

1. Stellen Sie sicher, dass Sie Node.js v20+ verwenden

node -v
# v20.x.x or higher

2. Klonen Sie dieses Repository:

git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
cd erickwendel-contributions-mcp

3. Installieren Sie die Abhängigkeiten:

npm ci

4. Starten Sie den Server:

npm start

Integration mit KI-Tools

Cursor-Einrichtung

Fügen Sie die folgende Konfiguration zu ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

Stellen Sie sicher, dass sich der Cursor-Chat im Agent-Modus befindet, indem Sie im Dropdown-Menü unten links "Agent" auswählen, und fragen Sie dann: "how many videos were published about JavaScript in 2024":

Lokale Entwicklung

Verwenden Sie für die lokale Entwicklung den absoluten Pfad zum Projekt:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

Claude Desktop-Einrichtung

1. Gehen Sie zu den Claude-Einstellungen

2. Klicken Sie auf den Reiter "Developer"

3. Klicken Sie auf "edit config"

4. Öffnen Sie die Konfiguration in einem Code-Editor

5. Fügen Sie die folgende Konfiguration zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) hinzu:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

Lokale Entwicklung

Verwenden Sie für die lokale Entwicklung den absoluten Pfad zum Projekt:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

MCPHost mit Ollama (Kostenlose Alternative)

Wenn Sie keinen Zugriff auf Claude Desktop oder Cursor haben, können Sie MCPHost mit Ollama als kostenlose Alternative verwenden.

1. Installieren Sie MCPHost:

go install github.com/mark3labs/mcphost@latest

2. Erstellen Sie eine Konfigurationsdatei (z. B. ./mcp.jsonc):

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

3. Ausführen mit Ollama:

ollama pull MODEL_NAME
mcphost --config ./mcp.jsonc -m ollama:MODEL_NAME

Lokale Entwicklung

Aktualisieren Sie für die lokale Entwicklung die Konfiguration:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

Beispielabfragen

Hier sind einige Beispiele für Abfragen, die Sie Claude, Cursor oder einem beliebigen MCP-Client stellen können:

1. "How many talks were given in 2023?"

2. "Show me talks in Spanish"

3. "Find posts about WebXR"

Entwicklung

Funktionen

• Erstellt mit dem Model Context Protocol (MCP)

• Volle MCP-Funktionalität: Tools, Prompts und Ressourcen

• Typsicher mit TypeScript und Zod-Schema-Validierung

• Native TypeScript-Unterstützung in Node.js ohne Transpilierung

• Generiertes SDK unter Verwendung von GenQL

• Modulare Architektur mit Trennung der Zuständigkeiten

• Standard-I/O-Transport für einfache Integration

• Strukturierte Fehlerbehandlung

• Kompatibel mit Claude Desktop, Cursor und MCPHost (kostenlose Alternative)

Hinweis: Dieses Projekt erfordert Node.js v23+, da es die native TypeScript-Unterstützung verwendet, die im letzten Jahr hinzugefügt wurde.

Architektur

Die Codebasis folgt einer modularen Struktur:

src/
  ├── config/      # Configuration settings
  ├── types/       # TypeScript interfaces and types
  ├── tools/       # MCP tool implementations
  ├── utils/       # Utility functions
  ├── services/    # API service layer
  └── index.ts     # Main entry point

Testen

So führen Sie die Test-Suite aus:

npm test

Für den Entwicklungsmodus mit Watch-Funktion:

npm run test:dev

Mitwirken

Beiträge sind willkommen! Bitte fühlen Sie sich frei, einen Pull Request einzureichen.

Autor

Erick Wendel

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe die Datei LICENSE für Details.