Erste Schritte mit AnythingMCP

Was ist AnythingMCP?

AnythingMCP ist ein Open-Source-Gateway, das deine REST-, SOAP-, GraphQL-APIs und Datenbanken in MCP-Server (Model Context Protocol) verwandelt. Einmal verbunden, können du über KI-Agenten wie Claude, ChatGPT, Copilot oder jeden MCP-kompatiblen Client mit deinen Systemen interagieren.

Voraussetzungen

• Docker und Docker Compose — Docker installieren
• Git — zum Klonen des Repositorys
• Ein Terminal — Bash unter macOS oder Linux

Für lokale Entwicklung ohne Docker (optional):

• Node.js 22+
• npm

Schnellstart

1. Repository klonen

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp

2. Setup-Skript ausführen

bash setup.sh

Der interaktive Assistent führt du durch die gesamte Konfiguration:

Schritt 1 — Bereitstellungsmodus Wähle zwischen Docker (empfohlen für Produktion) oder lokaler Entwicklung.

Schritt 2 — Domain & Ports Gib deinen Hostnamen ein. Für die lokale Nutzung behalten du die Standardeinstellung localhost bei. Für die Produktion geben du deine Domain ein (z.B. mcp.example.com) und das Skript konfiguriert Caddy als Reverse-Proxy mit automatischem Let's Encrypt SSL.

Schritt 3 — Geheimnisse Alle Sicherheitsanmeldedaten werden automatisch generiert:

• JWT-Geheimnis für die Authentifizierung
• Verschlüsselungsschlüssel für sensible Daten
• Datenbank-Passwort
• NextAuth-Geheimnis

Schritt 4 — MCP-Authentifizierung Wähle, wie sich KI-Agenten an deinem MCP-Endpunkt authentifizieren:

• OAuth 2.0 (empfohlen)
• API-Schlüssel / Bearer Token (Legacy)
• Beides (OAuth + Legacy-Fallback)
• Keine (nur für Entwicklung)

Schritt 5 — E-Mail (Optional) Konfiguriere SMTP für Benutzerverifizierung, Einladungen und Passwort-Zurücksetzung.

Schritt 6 — Redis (Optional) Aktiviere Redis für Ratenbegrenzung und Antwort-Caching.

Das Skript generiert die .env-Datei, konfiguriert Docker Compose und startet alle Dienste automatisch.

3. Dashboard öffnen

Sobald die Einrichtung abgeschlossen ist, öffnen du das Dashboard:

• Lokal: http://localhost:3000
• Mit Domain: https://mcp.example.com

Registriere dein Administratorkonto — der erste Benutzer, der sich registriert, wird zum Administrator.

deine erste API verbinden

1. Meld sich im Dashboard an
2. Klicke auf Connector erstellen
3. Wähle deinen Connector-Typ (REST, SOAP, GraphQL oder Datenbank)
4. Konfiguriere die Verbindung (importieren du eine OpenAPI-Spezifikation, WSDL oder geben du Datenbank-Anmeldedaten ein)
5. Speichern und aktivieren

dein MCP-Endpunkt ist bereit unter:

http://localhost:4000/mcp

Einen KI-Agenten verbinden

Füge deinen MCP-Server zu einem kompatiblen KI-Client hinzu. Beispiel für Claude Desktop (oder fügen du deine Server-URL direkt in Claude.ai → Connectors hinzu):

{
  "mcpServers": {
    "my-server": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

Architektur

AnythingMCP läuft als einzelner Container mit zwei Diensten:

Zusätzliche Dienste:

• PostgreSQL 17 — speichert Connectoren, Benutzer und Konfiguration
• Caddy (optional) — Reverse-Proxy mit automatischem SSL
• Redis (optional) — Ratenbegrenzung und Antwort-Caching

Häufige Befehle

# Logs anzeigen
docker compose logs -f

# Dienste neustarten
docker compose restart

# Dienste stoppen
docker compose down

# Auf die neueste Version aktualisieren
git pull && docker compose up -d --build

Nächste Schritte

• Was ist MCP? — Das Model Context Protocol verstehen
• REST API zu MCP — deine erste REST API verbinden
• Datenbank zu MCP — Datenbanken direkt verbinden
• Auf Hetzner bereitstellen — Produktionsbereitstellung mit SSL
• Auf AWS bereitstellen — Auf EC2 bereitstellen