MSIM – MCP Server Integration Manager

MSIM ist ein einheitlicher MCP-Server (Model Context Protocol), der AnythingLLM mit jedem MCP-kompatiblen Client (Better DeepSeek, Claude Desktop, Cursor, VS Code, benutzerdefinierte Agents) verbindet.

Er bietet einen einzigen Endpunkt für HTTP/JSON‑RPC-, SSE- und WebSocket-Transporte und verwaltet automatisch Workspace-Auswahl, Protokollierung und Hintergrundbetrieb.

Funktionen

• Vollständige MCP-Unterstützung – initialize, tools/list, tools/call, notifications/initialized, ping, prompts/list, resources/list.

• Multi-Transport – HTTP (/mcp), SSE (/sse), WebSocket (/ws).

• Automatische Workspace-Erkennung – verwendet den ersten Workspace, falls keiner angegeben ist.

• Interaktive Einrichtung – fragt beim ersten Start nach AnythingLLM-API-Schlüssel, Basis-URL und Workspace.

• Strukturierte Protokollierung & Rotation – JSON- oder Klartext-Logs mit automatischer Rotation.

• Sanftes Herunterfahren – wartet, bis laufende Tool-Aufrufe abgeschlossen sind.

• Supervisor-Modus – automatischer Neustart bei Absturz (begrenzbar).

• Endpoint-Banner – zeigt beim Start alle verfügbaren URLs an.

• Docker-Unterstützung – läuft mit docker-compose up zusammen mit AnythingLLM.

• Plattformübergreifend – funktioniert unter Windows, macOS, Linux.

Related MCP server: anythingllm-mcp

Installation

Voraussetzungen

• Git (zum Klonen des Repositorys)

• AnythingLLM – lokal ausgeführt (Desktop oder Docker) mit einem Developer-API-Schlüssel (in Einstellungen → API-Schlüssel erstellen).

Schnellinstallation (manuell)

git clone https://github.com/giancbaring/msim
cd msim
git submodule update --init --recursive
./install.sh   # or install.ps1 on Windows

Der Installer führt Folgendes aus:

1. uv installieren (falls fehlend).

2. Python 3.12 über uv installieren (falls fehlend).

3. Alte virtuelle Umgebung entfernen.

4. Alle Python-Abhängigkeiten installieren (einschließlich des Wrappers).

5. Code validieren.

6. Interaktive Einrichtung ausführen (fragt nach API-Schlüssel, Basis-URL und Workspace).

Docker-Installation (empfohlen, da einfach)

git clone https://github.com/giancbaring/msim
cd msim
docker-compose up

Dies startet AnythingLLM (offizieller Container) auf Port 3001 und MSIM auf Port 8000 – alles ist vorkonfiguriert.

Verwendung

Nach der Installation MSIM ausführen:

uv run python MSIM.py          # interactive menu
uv run python MSIM.py serve    # foreground server
uv run python MSIM.py start    # background daemon
uv run python MSIM.py stop     # stop daemon
uv run python MSIM.py status   # check status
uv run python MSIM.py logs     # view logs
uv run python MSIM.py install  # install as Windows service (NSSM)
uv run python MSIM.py uninstall # remove service

Endpunkte

Konfiguration

Die Einstellungen werden in .env gespeichert (während der Einrichtung erstellt). Sie können auch Umgebungsvariablen setzen, um sie zu überschreiben.

Wichtige Variablen:

• ANYTHINGLLM_BASE_URL – Standard http://localhost:3001

• ANYTHINGLLM_API_KEY – Ihr Developer-API-Schlüssel

• CORS_ORIGINS – durch Kommas getrennte Browser-Ursprünge, die auf MSIM zugreifen dürfen

• WORKSPACE – Standard-Workspace-Slug (automatisch erkannt, wenn leer)

• PORT – Server-Port (Standard 8000)

• MSIM_HOST – Bind-Adresse (Standard 127.0.0.1; Docker verwendet 0.0.0.0)

• MSIM_ALLOW_LOCAL_FILE_UPLOAD – lokale Datei-Upload-Tools explizit aktivieren (Standard false)

• LOG_FORMAT – plain oder json

• SUPERVISE_MAX_RESTARTS – maximale Neustarts pro Minute (Supervisor-Modus)

Mitwirken

Eröffnen Sie gerne Issues oder Pull Requests auf GitHub.

Siehe CONTRIBUTING.md, CODE_OF_CONDUCT.md und SECURITY.md für die Beitrags-, Community- und Sicherheitsrichtlinien von MSIM. Das Upstream-Submodul anythingllm-mcp hat separate Richtlinien und Zuschreibungsbedingungen.

Lizenz

Die ursprüngliche MSIM-Arbeit wird unter der MIT-Lizenz veröffentlicht; siehe LICENSE für die vollständigen Bedingungen und den Hinweis zum Geltungsbereich.

Das Verzeichnis submodules/anythingllm-mcp ist ein unabhängig lizenziertes Upstream-Projekt. Seine Urheberrechts-, Lizenz- und Zuschreibungsbedingungen bleiben in diesem Verzeichnis und gelten für diesen Upstream-Code.