Wie man einen MCP-Server mit Umgebungsparametern in Cursor konfiguriert

Die Konfiguration von Model Context Protocol (MCP) Servern mit Umgebungsparametern in Cursor ermöglicht es Ihnen, sensible Informationen sicher zu übermitteln und das Serververhalten anzupassen. Diese Anleitung bietet detaillierte Anweisungen zur Einrichtung und Verwaltung von Umgebungsvariablen für Ihre MCP-Server.

Einführung in die MCP-Server-Umgebungskonfiguration

Model Context Protocol (MCP) Server erweitern die KI-Fähigkeiten von Cursor durch zusätzliche Tools und Ressourcen. Umgebungsparameter ermöglichen es Ihnen:

API-Schlüssel und Authentifizierungs-Tokens sicher zu übermitteln
Serververhalten ohne Codeänderungen zu konfigurieren
Verschiedene Umgebungen einzurichten (Entwicklung, Staging, Produktion)
Serverfunktionalität basierend auf dem Bereitstellungskontext anzupassen

Warum Umgebungsparameter verwenden?

Umgebungsparameter bieten mehrere Vorteile:

Sicherheit: Sensible Informationen bleiben außerhalb des Codes
Flexibilität: Konfigurationsänderungen ohne Codemodifikation
Portabilität: Gleicher Server in verschiedenen Umgebungen
Trennung der Belange: Konfiguration getrennt von Implementierung

MCP-Server-Konfiguration verstehen

Bevor Sie Umgebungsparameter hinzufügen, ist es wichtig, die grundlegende Struktur der MCP-Server-Konfiguration in Cursor zu verstehen.

MCP-Konfigurationsdateistruktur

MCP-Server werden in einer JSON-Datei mit folgender Struktur konfiguriert:

{
  "mcpServers": {
    "server-name": {
      "command": "node",
      "args": ["/path/to/server.js"],
      "env": {
        "KEY1": "value1",
        "KEY2": "value2"
      },
      "disabled": false,
      "autoApprove": ["tool1", "tool2"]
    }
  }
}

Hauptkomponenten:

server-name: Ein eindeutiger Bezeichner für Ihren MCP-Server
command: Der Befehl zum Ausführen Ihres Servers (z.B. node, python)
args: Argumente, die an den Befehl übergeben werden
env: Umgebungsvariablen für den Serverprozess
disabled: Ob der Server deaktiviert ist
autoApprove: Liste von Tools, die keine explizite Genehmigung benötigen

Schritt-für-Schritt Konfigurationsanleitung

1. MCP-Konfigurationsdatei lokalisieren

Der Speicherort Ihrer MCP-Konfigurationsdatei hängt von Ihrem Betriebssystem ab:

Windows:

%APPDATA%\Code\User\globalStorage\tencent-cloud.coding-copilot\settings\Craft_mcp_settings.json

macOS:

~/Library/Application Support/Code/User/globalStorage/tencent-cloud.coding-copilot/settings/Craft_mcp_settings.json

Linux:

~/.config/Code/User/globalStorage/tencent-cloud.coding-copilot/settings/Craft_mcp_settings.json

2. Konfigurationsdatei bearbeiten

Öffnen Sie die Konfigurationsdatei in Ihrem bevorzugten Texteditor
Wenn die Datei nicht existiert oder leer ist, erstellen Sie sie mit folgender Struktur:

{
  "mcpServers": {}
}

Fügen Sie Ihre Serverkonfiguration hinzu oder ändern Sie sie:

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/path/to/my-server.js"],
      "env": {
        "API_KEY": "your-api-key-here",
        "DEBUG": "true",
        "PORT": "3000"
      },
      "disabled": false
    }
  }
}

3. Umgebungsparameter hinzufügen

So fügen Sie Umgebungsparameter zu Ihrem MCP-Server hinzu:

Identifizieren Sie die benötigten Umgebungsvariablen
Fügen Sie sie zum env-Objekt in Ihrer Serverkonfiguration hinzu
Speichern Sie die Konfigurationsdatei

Beispiel mit mehreren Umgebungsvariablen:

"env": {
  "OPENAI_API_KEY": "sk-abcdef123456",
  "SERVER_PORT": "3000",
  "LOG_LEVEL": "info",
  "CACHE_ENABLED": "true",
  "MAX_TOKENS": "4096",
  "MODEL_NAME": "gpt-4",
  "TIMEOUT_MS": "30000"
}

4. Umgebungsvariablen im MCP-Server verwenden

In Ihrem MCP-Server-Code können Sie auf diese Umgebungsvariablen zugreifen:

JavaScript/Node.js:

const apiKey = process.env.API_KEY;
const debug = process.env.DEBUG === 'true';
const port = parseInt(process.env.PORT || '3000', 10);

console.log(`Starting server with API key ${apiKey} on port ${port}`);
if (debug) {
  console.log('Debug mode enabled');
}

Python:

import os

api_key = os.environ.get('API_KEY')
debug = os.environ.get('DEBUG') == 'true'
port = int(os.environ.get('PORT', '3000'))

print(f"Starting server with API key {api_key} on port {port}")
if debug:
    print("Debug mode enabled")

Fortgeschrittene Konfigurationstechniken

Verwendung von Umgebungsdateien

Für komplexere Konfigurationen können Sie Umgebungsdateien verwenden:

Erstellen Sie eine .env-Datei:

API_KEY=your-api-key-here
DEBUG=true
PORT=3000

Aktualisieren Sie Ihre MCP-Server-Konfiguration:

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/path/to/my-server.js"],
      "env": {
        "ENV_FILE": "/path/to/.env"
      }
    }
  }
}

Laden Sie die Umgebungsdatei in Ihrem Server-Code:

JavaScript/Node.js (mit dotenv):

require('dotenv').config({ path: process.env.ENV_FILE });

// Jetzt können Sie auf die Variablen zugreifen
const apiKey = process.env.API_KEY;

Python (mit python-dotenv):

import os
from dotenv import load_dotenv

load_dotenv(os.environ.get('ENV_FILE'))

# Jetzt können Sie auf die Variablen zugreifen
api_key = os.environ.get('API_KEY')

Umgebungsvariablen-Expansion

Sie können andere Umgebungsvariablen in Ihrer Konfiguration referenzieren:

"env": {
  "BASE_URL": "https://api.example.com",
  "API_ENDPOINT": "${BASE_URL}/v1/data",
  "HOME_DIR": "${HOME}/projects"
}

Verwendung von System-Umgebungsvariablen

Sie können System-Umgebungsvariablen in Ihrer Konfiguration referenzieren:

"env": {
  "USER_HOME": "${HOME}",
  "SYSTEM_TEMP": "${TEMP}",
  "CURRENT_USER": "${USER}"
}

Sicherheits-Best-Practices

Bei der Arbeit mit Umgebungsparametern, besonders für sensible Informationen wie API-Schlüssel, befolgen Sie diese Sicherheits-Best-Practices:

1. Niemals sensible Informationen committen

Verwenden Sie .gitignore zum Ausschließen von Umgebungsdateien
Committen Sie keine Konfigurationsdateien mit echten API-Schlüsseln
Verwenden Sie Platzhalter-Werte in committeten Beispielen

2. Verschlüsselung für sensible Werte verwenden

Erwägen Sie die Verschlüsselung sensibler Umgebungsvariablen
Nutzen Sie wenn möglich ein sicheres Schlüsselverwaltungssystem

3. Zugriff auf Konfigurationsdateien beschränken

Setzen Sie angemessene Dateiberechtigungen
Beschränken Sie, wer Konfigurationsdateien einsehen und bearbeiten kann

4. Regelmäßige Rotation von Geheimnissen

Ändern Sie API-Schlüssel und Tokens periodisch
Aktualisieren Sie Ihre Konfigurationsdateien bei Änderungen der Geheimnisse

5. Umgebungsvariablen validieren

Validieren Sie in Ihrem Server-Code die Umgebungsvariablen vor der Verwendung:

function validateEnv() {
  const requiredVars = ['API_KEY', 'SERVER_PORT'];
  const missing = requiredVars.filter(varName => !process.env[varName]);
  
  if (missing.length > 0) {
    throw new Error(`Fehlende erforderliche Umgebungsvariablen: ${missing.join(', ')}`);
  }
}

validateEnv();

Fehlerbehebung bei häufigen Problemen

Umgebungsvariablen nicht verfügbar

Problem: In MCP-Einstellungen konfigurierte Umgebungsvariablen sind in Ihrem Server nicht verfügbar.

Lösungen:

Überprüfen Sie die Konfigurationsdatei-Syntax
Stellen Sie sicher, dass der Server korrekt gestartet wird
Starten Sie Cursor nach Konfigurationsänderungen neu
Prüfen Sie Server-Logs auf umgebungsbezogene Fehler

Konfigurationsdatei nicht gefunden

Problem: Cursor kann Ihre MCP-Konfigurationsdatei nicht finden.

Lösungen:

Überprüfen Sie, ob der Dateipfad für Ihr Betriebssystem korrekt ist
Erstellen Sie die Verzeichnisstruktur, falls sie nicht existiert
Überprüfen Sie die Dateiberechtigungen
Starten Sie Cursor nach Erstellung der Datei neu

Ungültiges JSON-Format

Problem: Konfigurationsdatei hat JSON-Syntaxfehler.

Lösungen:

Validieren Sie Ihr JSON mit einem JSON-Validator
Prüfen Sie auf fehlende Kommas, Klammern oder Anführungszeichen
Stellen Sie sicher, dass alle Eigenschaftsnamen in doppelten Anführungszeichen stehen
Entfernen Sie nachfolgende Kommas

Server stürzt beim Start ab

Problem: MCP-Server stürzt sofort nach dem Start ab.

Lösungen:

Prüfen Sie Server-Logs auf Fehlermeldungen
Stellen Sie sicher, dass alle erforderlichen Umgebungsvariablen vorhanden sind
Überprüfen Sie, ob Umgebungsvariablenwerte das richtige Format haben
Prüfen Sie auf Pfadprobleme in Dateireferenzen

Beispiele für häufige Anwendungsfälle

1. OpenAI API-Integration

{
  "mcpServers": {
    "openai-tools": {
      "command": "node",
      "args": ["/path/to/openai-server.js"],
      "env": {
        "OPENAI_API_KEY": "sk-your-key-here",
        "MODEL": "gpt-4",
        "MAX_TOKENS": "8192",
        "TEMPERATURE": "0.7"
      }
    }
  }
}

2. Datenbankverbindung

{
  "mcpServers": {
    "db-tools": {
      "command": "python",
      "args": ["/path/to/db-server.py"],
      "env": {
        "DB_HOST": "localhost",
        "DB_PORT": "5432",
        "DB_NAME": "mydb",
        "DB_USER": "user",
        "DB_PASSWORD": "password",
        "CONNECTION_POOL_SIZE": "10"
      }
    }
  }
}

3. Entwicklungs- vs. Produktionseinstellungen

{
  "mcpServers": {
    "api-tools": {
      "command": "node",
      "args": ["/path/to/api-server.js"],
      "env": {
        "NODE_ENV": "development",
        "API_URL": "http://localhost:8080/api",
        "CACHE_ENABLED": "false",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

Fazit

Die Konfiguration von MCP-Servern mit Umgebungsparametern in Cursor bietet eine flexible, sichere Möglichkeit, das Serververhalten anzupassen und sensible Informationen zu verwalten. Durch Befolgen der in dieser Anleitung beschriebenen Schritte und Best Practices können Sie Umgebungsvariablen für Ihre MCP-Server effektiv einrichten und verwalten.

Ob Sie externe APIs integrieren, Datenbankverbindungen herstellen oder einfach das Serververhalten anpassen - Umgebungsparameter bieten eine saubere Trennung zwischen Konfiguration und Code und verbessern damit Sicherheit und Wartbarkeit.

Einführung in die MCP-Server-Umgebungskonfiguration​

Warum Umgebungsparameter verwenden?​

MCP-Server-Konfiguration verstehen​

MCP-Konfigurationsdateistruktur​

Schritt-für-Schritt Konfigurationsanleitung​

1. MCP-Konfigurationsdatei lokalisieren​

2. Konfigurationsdatei bearbeiten​

3. Umgebungsparameter hinzufügen​

4. Umgebungsvariablen im MCP-Server verwenden​

Fortgeschrittene Konfigurationstechniken​

Verwendung von Umgebungsdateien​

Umgebungsvariablen-Expansion​

Verwendung von System-Umgebungsvariablen​

Sicherheits-Best-Practices​

1. Niemals sensible Informationen committen​

2. Verschlüsselung für sensible Werte verwenden​

3. Zugriff auf Konfigurationsdateien beschränken​

4. Regelmäßige Rotation von Geheimnissen​

5. Umgebungsvariablen validieren​

Fehlerbehebung bei häufigen Problemen​

Umgebungsvariablen nicht verfügbar​

Konfigurationsdatei nicht gefunden​

Ungültiges JSON-Format​

Server stürzt beim Start ab​

Beispiele für häufige Anwendungsfälle​

1. OpenAI API-Integration​

2. Datenbankverbindung​

3. Entwicklungs- vs. Produktionseinstellungen​

Fazit​

Zusätzliche Ressourcen​

Einführung in die MCP-Server-Umgebungskonfiguration

Warum Umgebungsparameter verwenden?

MCP-Server-Konfiguration verstehen

MCP-Konfigurationsdateistruktur

Schritt-für-Schritt Konfigurationsanleitung

1. MCP-Konfigurationsdatei lokalisieren

2. Konfigurationsdatei bearbeiten

3. Umgebungsparameter hinzufügen

4. Umgebungsvariablen im MCP-Server verwenden

Fortgeschrittene Konfigurationstechniken

Verwendung von Umgebungsdateien

Umgebungsvariablen-Expansion

Verwendung von System-Umgebungsvariablen

Sicherheits-Best-Practices

1. Niemals sensible Informationen committen

2. Verschlüsselung für sensible Werte verwenden

3. Zugriff auf Konfigurationsdateien beschränken

4. Regelmäßige Rotation von Geheimnissen

5. Umgebungsvariablen validieren

Fehlerbehebung bei häufigen Problemen

Umgebungsvariablen nicht verfügbar

Konfigurationsdatei nicht gefunden

Ungültiges JSON-Format

Server stürzt beim Start ab

Beispiele für häufige Anwendungsfälle

1. OpenAI API-Integration

2. Datenbankverbindung

3. Entwicklungs- vs. Produktionseinstellungen

Fazit

Zusätzliche Ressourcen