MCP-Server-Vorlage für Cursor IDE

Eine Vorlage zum Erstellen eigener Tools für Cursor IDE mithilfe des Model Context Protocol (MCP). Erstellen Sie Ihr eigenes Repository aus dieser Vorlage, passen Sie die Tools an und verbinden Sie sie mit Ihrer Cursor IDE.

Schnellstart

1. Klicken Sie auf die Schaltfläche „Deploy to Heroku"

   

2. Konfigurieren Sie nach der Bereitstellung Cursor:

   • Öffnen Sie Cursor-Einstellungen → Funktionen

   • Fügen Sie einen neuen MCP-Server hinzu

   • Verwenden Sie Ihre Heroku-URL mit dem Pfad /sse (z. B. https://<your-app-name>.herokuapp.com/sse)

3. Testen Sie die Stimmung Ihres Servers in Cursor:

   • Fragen Sie Ihren Agenten: „Bitte fragen Sie nach der Stimmung unseres Servers und teilen Sie mir mit, wie es ihm geht."

   • Der Server antwortet mit einer fröhlichen Nachricht und einem Herz ❤️

Related MCP server: pure.md MCP server

Alternative Einrichtungsmethoden

Sie können den Server auf drei Arten ausführen: mit Docker, mit der herkömmlichen Python-Einrichtung oder direkt in der Cursor IDE.

Docker-Einrichtung

Das Projekt enthält Docker-Unterstützung für eine einfache Bereitstellung:

1. Ersteinrichtung:

# Clone the repository
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server

# Create environment file
cp .env.example .env

2. Erstellen und Ausführen mit Docker Compose:

# Build and start the server
docker compose up --build -d

# View logs
docker compose logs -f

# Check server status
docker compose ps

# Stop the server
docker compose down

3. Der Server ist verfügbar unter:

   • SSE-Endpunkt: http://localhost:8000/sse

4. Schnelltest:

# Test the server endpoint
curl -i http://localhost:8000/sse

5. Verbinden Sie sich mit Cursor IDE:

   • Öffnen Sie Cursor-Einstellungen → Funktionen

   • Fügen Sie einen neuen MCP-Server hinzu

   • Typ: Wählen Sie „sse"

   • URL: Geben Sie http://localhost:8000/sse ein

Herkömmliche Einrichtung

Installieren Sie zuerst den Paketmanager uv:

# Install uv on macOS
brew install uv
# Or install via pip (any OS)
pip install uv

Starten Sie den Server entweder über stdio (Standard) oder über den SSE-Transport:

# Install the package with development dependencies
uv pip install -e ".[dev]"

# Using stdio transport (default)
uv run mcp-simple-tool

# Using SSE transport on custom port
uv run mcp-simple-tool --transport sse --port 8000

# Run tests
uv run pytest -v

Nach der Installation können Sie den Server direkt mit der Cursor IDE verbinden:

1. Klicken Sie mit der rechten Maustaste auf die Datei cursor-run-mcp-server.sh in Cursor

2. Wählen Sie „Pfad kopieren", um den absoluten Pfad zu kopieren

3. Öffnen Sie die Cursor-Einstellungen (Zahnradsymbol)

4. Navigieren Sie zur Registerkarte „Funktionen"

5. Scrollen Sie nach unten zu „MCP-Server"

6. Klicken Sie auf „Neuen MCP-Server hinzufügen"

7. Füllen Sie das Formular aus:

   • Name: Wählen Sie einen beliebigen Namen (z. B. „my-mcp-server-1")

   • Typ: Wählen Sie „stdio" (nicht „sse", da wir den Server lokal ausführen)

   • Befehl: Fügen Sie den absoluten Pfad zu cursor-run-mcp-server.sh ein, den Sie zuvor kopiert haben. Zum Beispiel: /Users/yourname/weaviate-mcp-server/cursor-run-mcp-server.sh

Umgebungsvariablen

Verfügbare Umgebungsvariablen (können in .env festgelegt werden):

• MCP_SERVER_PORT (Standard: 8000) – Port, auf dem der Server läuft

• MCP_SERVER_HOST (Standard: 0.0.0.0) – Host, an den der Server gebunden ist

• DEBUG (Standard: false) – Debug-Modus aktivieren

• MCP_USER_AGENT – Benutzerdefinierter User-Agent für das Abrufen von Websites

Zusätzliche Optionen

Installation über Smithery

So installieren Sie die MCP-Server-Vorlage für Cursor IDE für Claude Desktop automatisch über Smithery:

npx -y @smithery/cli install @kirill-markin/example-mcp-server --client claude

Glama-Server-Überprüfung